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The System Monitor 



Purpose of this Publication 

This publication describes use of the System Monitor 
to control the 1410/7010 Operating; System. Informa- 
tion is included about the functions and components 
of the System Monitor and its relationship to the Op- 
erating System. The publication also gives instructions 
for writing programs to run under control of the Sys- 
tem Monitor. 

Purpose of the System Monitor 

The System Monitor controls the 1410/7010 Operat- 
ing System. Some of the functions that it performs for 
programs within the Operating System are: 

1. Assignment of input/output units. 

2. Program loading, including relocation of pro- 
. grams, and linkage between programs and sub- 
routines that were independently written and 
compiled. 

3. Programmed transition from run to run and job 
to job. 

The Operating System can provide, at the option of 
each installation, control facilities for ibm Tele-Pro- 
cessing® Systems. Detailed information concerning 
this type of application is contained in the publication 
IBM 1410/7010 Operating System; Tele-Processing 
Supervisor, Form C28-0321. 



Prerequisite and Related Literature 

The publication, IBM 1410/7010 Operating System; 
Basic Concepts, Form C28-0318, is a prerequisite. The 
reader is assumed to be familiar with both the termi- 
nology and concepts defined by that publication. 

For a disk-oriented 1410 or 7010 Data Processing 
System, the publication, IBM 1301 Disk Storage with 
IBM 1410 and 7010 Systems, Form A22-6670, is a pre- 
requisite. 

Related literature includes the following publica- 
tions, which contain detailed information about the 
other elements and functions of the 1410/7010 Oper- 
ating System: 

System Generation, Form C28-0352 

Basic Input/Output Control System, Form C28-0322 

Tele-Processing® Supervisor, Form C28-0321 

Utility Programs, Form C28-0353 

Generalized Tape Sorting Program, Form C28-0354 

Random-Processing Scheduler, Form C28-0323 

Autocoder, Form C28-0326 

FORTRAN, Form C28-0328 

COBOL, Form C28-0327 

Operators Guide, Form C28-0351 
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System Monitor Concepts 



The System Monitor coordinates the functions of all 
Operating System components, including user-written 
programs operating under it. In this coordination, the 
System Monitor does the following: 

1. It reads and analyzes control cards that describe 
functions to be performed. 

2. It assigns input/output units. 

3. It reads programs from the card reader, tapes, or 
disk. These programs may be requested by control 
cards or by imbedded calls within programs. 

4. It relocates these programs to unused areas of 
storage, provides communication among program ele- 
ments, and loads the programs into storage. 

5. It turns processing control over to the programs 
in storage and receives control from them when they 
are completed. These dependent programs may be 
user-written programs or IBM-provided components of 
the Operating System. 

6. It handles all input/output operations for de- 
pendent programs. 

To perform these control functions, a part of the 
System Monitor, the Resident Monitor, stays in lower 
core storage at all times. The Resident Monitor loads 
programs into core storage, handles input/output, and 
controls end-of-program actions. 

The rest of the System Monitor and all other com- 
ponents of the Operating System are kept on tape or 
disk and are brought into core storage as required. 
The other parts of the System Monitor are: 

1. Transitional Monitor, which analyzes control 
cards and assigns input/output units. 

2. Linkage Loader, which relocates programs and 
provides communication among independently com- 
piled program elements. 

Programs compiled by the language processors are 
in relocatable format. Relocatable programs have been 
arbitrarily assigned locations by the language proces- 
sors or the programmer. The Linkage Loader ( 1 ) re- 
locates the addresses in the relocatable programs to 
core locations above the Resident Monitor, and above 
other programs that will be in storage below the pro- 
gram; or (2) relocates the addresses to installation- 
specified locations. After relocation, programs are in 
absolute format. The absolute addresses in these pro- 
grams are the addresses the programs will use when 
they are executed. 

The over-all operation of the System Monitor is 
shown in Figure 1. 
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Figure 1. Operation of the System Monitor 



Programs to be tested can be run under control of 
the System Monitor in the same way as fully tested 
programs. One or more Utility programs of the Oper- 
ating System can be run at selected points during pro- 
gram execution and/or at the end of program to dump 
core storage, tapes, or disk. 



Use of the System Monitor 

Five types of control information are supplied by the 
installation to the System Monitor: 

1. Monitor control cards. Monitor control cards are 
identified by mon$$ in columns 6 through 10. These 
cards initiate program execution, assign input/output 
units to programs, and supply certain information to 
the System Monitor. They are described in the section, 
"Use of Transitional Monitor." 

2. Linkage Loader control cards. These cards se- 
lect the elements composing a program and control 
program relocation. They are described in the section, 
"Use of Linkage Loader." 

3. Imbedded calls. These are requests coded in a 
dependent program to incorporate elements into the 
program. They are described in the section, "Use of 
Linkage Loader." 

4. Linkage sequences. These are coding sequences 
within a dependent program that enable the program 
to use facilities of the Resident Monitor. Each se- 
quence contains a branch instruction and may alsb 
contain one or more fields of control information. The 
branch instruction gives control to a routine in the 
Resident Monitor. These sequences are described in 
the section, "Use of Resident Monitor Functions." 

5. Console inquiries. These are control messages 
typed on the console printer by the operator. They are 
described in the section, "Messages and Inquiries." 



Batch Processing 

A major advantage of the System Monitor is that it 
permits batching programs, that is, running programs 
in groups, with minimum operator intervention. Pro- 
gram batches are subdivided into: 

1. Jobs 

2. Runs 

The day's work is divided into jobs. Each job corh- 
sists of one or more program executions, called runs, 
plus control information. All programs in a job must 
have compatible input/output assignments. 

The usual job is a request for a program in absolute 
format, residing on tape or disk, plus the necessary 
control information and input data, 

However, almost limitless combinations of runs can 
be performed in a single job. For example, a job can 
include a compilation, relocation of all programs in 
the job, execution of programs to test them, use of 
one or more of the Utility Programs, and execution 
of one or more fully tested production programs. 

Programs in source language may just be compiled, 
or may be compiled and executed ( compile-and-go op- 



eration) within one job. However, if errors are found 
in compilation, the request for execution of the com- 
piled program will be automatically canceled. 



Program Construction 

For the Operating System, a program is constructed 
of one or more phases. Many programs will consist of 
only one phase. If a program is too large for storage, 
it must consist of several phases; the phases are exe- 
cuted in succession, with each phase partly or com- 
pletely overlaying the preceding phase. 

Each phase consists of one or more subprograms. A 
subprogram is the basic program unit with which the 
Linkage Loader performs its processing. 

For the purposes of the Linkage Loader, a subpro- 
gram begins with a title card and ends with a Ter- 
mination card. The cards between the title and Ter- 
mination cards contain the relocatable statements pro- 
duced by a language processor. (See the section, "Use 
of Linkage Loader," for a description of the title 
card. Termination cards are described in the section, 
"Program Patching.") 

A subprogram can be an entire, self-contained pro- 
gram, or it can be a closed subroutine to be executed 
in conjunction with other subprograms to form a 
phase. 

The subprograms in a job may be in source lan- 
guage, requiring compilation, or in relocatable form. 
If a job contains more than one subprogram, it may 
contain a mixture of source and relocatable decks. In 
a job, a relocatable subprogram may accompany the 
control cards, or it may reside in a program library 
on tape or disk. In the latter case, the control cards 
must include a call for the subprogram, or another 
subprogram in the job must contain an imbedded call. 

Subprograms are divided into two types: primary 
and secondary. A primary subprogram has an initial 
entry point specified by its Termination card. A pri- 
mary subprogram may be a phase in itself or may 
form the nucleus for a group of subprograms to be 
made into a single, executable phase. A secondary 
subprogram does not have an initial entry point on its 
Termination card. Secondary subprograms may com- 
pose a complete phase or may be combined with a pri- 
mary subprogram to form a phase. 

In Autocoder, for example, the distinction between 
primary and secondary subprograms is based on the 
end or spend statements. If the programmer specifies 
an address in one of these statements, that address is 
used for the initial entry point of the subprogram, and 
the language processor informs the Linkage Loader 
that this is a primary subprogram. If the operand of 
the end or spend statement is blank, the language 
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processor informs the Linkage Loader that this is a 
secondary subprogram. 

A program must contain at least one primary sub- 
program to establish the initial entry point for exe- 
cution of the program. For a multiphase program, the 
first phase must include at least one primary subpro- 
gram. Succeeding phases may or may not contain pri- 
mary subprograms. If the succeeding phase is of an 
executable nature, the preceding phase must contain 
the linkage to initiate its execution. 

The initial entry point of a program phase is estab- 
lished by the Termination card of the first primary 
subprogram processed for that phase. The Linkage 
Loader ignores entry points specified in other Termi- 
nation cards processed within that phase. 



Communication Symbols 

The System Monitor enables use of symbolic refer- 
ences, called communication symbols, so that a sub- 
program can refer to a routine in another separately 
compiled subprogram and to parts of the Resident 
Monitor. 

The two types of communication symbols are: 

1. Linkage symbols, which are used for communi- 
cation between subprograms. 

2. System symbols, which are used for communi- 
cation from a subprogram to routines or data fields of 
the Resident Monitor. 

Autocoder includes language statements that direct- 
ly relate to the use of communication symbols. For 
the most part, cobol and Fortran automatically gen- 
erate these symbols as they are needed in a program. 

Linkage Symbols 

Linkage symbols are established by two types of 
cards: the title card at the beginning of a subpro- 
gram, and Definition cards included in a subprogram. 
(Autocoder includes the defin statement for the cre- 
ation of Definition cards.) 

Each time the Linkage Loader encounters one of 
these cards, it places into its symbol table the char- 
acters that have been declared as the linkage symbol 
and the relocated address assigned by the Linkage 
Loader to the symbol. For example, a title card de- 
clares a subprogram name as a linkage symbol, and 
the origin point of the subprogram (after relocation) 
becomes the address assigned to that linkage symbol. 
This procedure enables a subsequent subprogram to 
refer to a previously processed subprogram by the 
linkage symbol that is the previous subprogram's 
name. 



A linkage symbol can appear in a subprogram in 
either of two formats : 

1. A symbol consisting of one to ten characters, 
such as a subprogram name. The first character must 
be alphabetic; the remaining characters can be alpha- 
betic or numeric. No special characters can be used. 
If the symbol is less than ten characters, it is left- 
justified, with trailing blanks in a ten-position field. 

2. A five-character symbol consisting of four char- 
acters followed by a slash ( abcd/ ) . The first character 
must be alphabetic; the next three characters can be 
alphabetic or numeric. 

Reference to linkage symbols of the first format are 
made by dcws and dcwf cards, cobol and Fortran 
automatically generate these cards as needed. Auto- 
coder includes language statements for the generation 
of these cards. When the Linkage Loader encounters 
a dcws card, it puts into the subprogram a branch in- 
struction containing the address assigned to the link- 
age symbol in the dcws card. A dcwf card causes the 
Linkage Loader to put into the subprogram a five- 
character constant that is the address equated to the 
linkage symbol. 

Note: dcws and dcwf cards can contain only one- 
to ten-character linkage symbols. 

dcws and dcwf cards are termed imbedded calls be- 
cause they are requests for subprograms coded into 
a subprogram. 

References to linkage symbols of the abcd/ format 
can be made by using the symbol in the A-field or B- 
field of an instruction or by using the symbol as an ad- 
dress constant. For example, in the Autocoder lan- 
guage, the programmer can use the defin statement 
to declare work/ as a linkage symbol that represents 
the address of a work area. The programmer can then 
use work/ in the operand of an instruction that refers 
to that work area, such as S+10,work/. Such an in- 
struction can be included in any other subprogram 
processed by the Linkage Loader during the same run 
as the subprogram that declared the linkage symbol. 

Note that linkage symbols are designed for use as 
references between separately compiled subprograms. 
Each of the language processors provides facilities for 
references within a subprogram. In Autocoder, these 
references (labels) are directly coded; the cobol and 
Fortran processors generate references as required. 

System Symbols 

System symbols are defined by the System Monitor 
and require no declaration by subprograms. Subpro- 
grams need only refer to them. These symbols, given 
in the section, "Use of Resident Monitor Functions," 
refer to routines and data in the Resident Monitor. 
All system symbols have the format /abc/. These 



symbols can appear in the operand of any instruction 
or as an address constant. The Linkage Loader con* 
verts all system symbols to actual addresses when it 
relocates the dependent programs. 



Listing of Communication Symbols 

The Linkage Loader produces a listing of all linkage 
symbols used during the processing of subprograms, 
Each symbol is listed with the core-storage address it 
represents. Thus, the listing shows the location of pro- 
gram elements after they have been relocated. 



For all system and linkage symbols that are not de- 
fined, the Linkage Loader will: 

1. Print all unresolved symbols. This list includes 
undefined communication symbols and all unfilled 
calls for subprograms. 

2. Leave undefined communication symbols in the 
instruction in which they appeared. 

The Linkage Loader will permit programs with un- 
defined communication symbols or unresolved calls to 
be executed; however, these programs will fail if exe- 
cution is attempted of an instruction containing an un- 
resolved call or undefined communication symbol. 
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Structure and Functions of the System Monitor 



Structure of the System Monitor 

The System Monitor consists of three major elements: 

1. Resident Monitor. This element contains the con- 
trol routines required while running dependent pro- 
grams and, therefore, remains in core storage at all 
times. 

2. Transitional Monitor. This element performs 
functions related to the transition from run to run and 
job to job. It is brought into storage by the Resident 
Monitor when transitional functions are needed. One 
of its major functions is the analysis and processing of 
Monitor control cards. 

3. Linkage Loader. This element performs the func- 
tions required to prepare relocatable programs for exe- 
cution. It is brought into storage by the Resident Mon- 
itor when requested by Monitor control cards. 



Functions of Resident Monitor 

Input/Output Control System 

The Input/Output Control System (iocs) is created 
during System Generation to meet the requirements of 
the installation. This iocs, termed the Resident IOCS, 
is in the Resident Monitor. It contains the basic rou- 
tines, such as those for error checking, that perform 
functions common to all input/output operations. (For 
detailed information concerning the Resident iocs, see 
the publication, Basic Input/Output Control System. ) 

Unit-Record Routines 

The Resident Monitor contains three routines to han- 
dle input/output operations for unit-record equipment. 
One of these routines is for card input ( Read routine ) , 
another for card output ( Punch routine ) , and the third 
for printer output (Print routine). Each of these rou- 
tines has an alternate routine that performs the unit- 
record functions with magnetic tape. For each unit- 
record function, the installation can specify whether 
the function is to be performed with magnetic tape or 
unit-record equipment. 

Assignment Routine 

Facilities for assigning input/output units for program 
use are included in the Resident Monitor and the 
Transitional Monitor. The Resident Monitor contains 
tables of information about the installation's input/ 
output equipment, and facilities for providing this 



information as required during program execution. 
The Transitional Monitor analyzes control card infor- 
mation related to input/output assignment and co- 
ordinates this information with the Resident Monitor's 
Assignment routine. 

End-of-Program Routine 

The End-of-Program routine analyzes each end of pro- 
gram to determine the function to be performed next. 
If it is a normal end of program ( successful completion 
of the program being executed ) , the Transitional Mon- 
itor is brought into storage to process the Monitor con- 
trol cards that define the next run. 

If the end of program is caused by program failure 
(unusual end of program), the End-of-Program rou- 
tine preserves the contents of core storage on tape, if a 
tape was provided for that purpose. The Transitional 
Monitor then processes the Monitor control cards for 
the next run, if the job or program is being tested, or 
skips to the control cards for the next job. 

A third type of end program, special end of pro- 
gram, is used by the Linkage Loader and the language 
processors to indicate that the contents of their output 
files are not valid. 

Load Routine 

The Load routine brings programs, which have been 
relocated and are ready for execution, into storage. 
These absolute-format programs are on the Job file 
produced by the Linkage Loader, or on the System 
Operating File. The Load routine loads from the file 
named in the Monitor control card that executes the 
program. (The files are discussed later in this section.) 

The Load routine also searches for phases required 
during the execution of a job. For example, this routine 
is used by one phase of a multiphase program to locate 
the next phase and bring it into storage. Each program 
phase, at its completion, specifies to the Load routine 
which phase is to be located next. Note that the next 
program phase need not be the next in numerical 
sequence. 

For example, Phase 1 of a program could issue a re- 
quest for Phase 2 or any other phase, basing its choice 
on the result of the processing in Phase 1. Dependent 
programs may also use the subroutines of the Load 
routine to read, search, backspace, and rewind the file 
from which the program was loaded. 

Note: The Load routine cannot load the two high- 
est core positions. The Operating System places group 
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marks with word marks in the two highest core posi- 
tions; these group marks with word marks must not b;e 
destroyed by dependent programs. 



Communication Region 

The Communication Region is a collection of fields 
that contain control information. Some fields contain 
information used for communication between various 
ibm programs within the Operating System; otheiis 
contain information of value to the user's program^. 
Some fields contain data; other fields contain addresses,. 

For example, one Communication Region field con- 
tains the current date. This field can be addressed by 
any program. The Resident iocs uses this field to deter- 
mine the date for writing and checking tape label$. 
The user's programs can address this field for such pud- 
poses as creating a header record for printer output. 

Communication Region fields can be modified only 
through the Resident Monitor's Modification routine, 
which is described in the section, "Use of Resident 
Monitor Functions." 

Wait-Loop Routine 

The Wait-Loop routine allows programs to suspend 
processing until the operator performs a specified func^ 
tion, such as changing forms on the printer. A program 
can write a message on the console printer, branch to 
the Wait-Loop routine, and resume processing aftej: 
the operator signals the Resident Monitor that the 
function specified by the message has been completed. 

Console Inquiry Routine 

Facilities for responding to console inquiries are in- 
cluded in both the Resident Monitor and the Transit 
tional Monitor. The Resident Monitor accepts console 
inquiries during a run, such as a signal from the oper- 
ator to exit from the Wait-Loop routine. The Transi- 
tional Monitor accepts console inquiries between jobs, 
such as a signal to begin reading from the Alternate 
Input Unit. 

The Console Inquiry routines (in both the Resident! 
and Transitional Monitors ) serve to communicate con- 
trol information to the System Monitor. Programs oper- 
ating under control of the System Monitor can also use 
the console printer for communication with the 
operator. 

Initialization Routine 

The Initialization routine performs housekeeping to 
prepare the System Monitor for work. This routine is! 
at the top of the Resident Monitor area and is overlaid 
by the first dependent program brought into storage.; 
The functions and use of the Initialization routine are 
explained in the publication, Operators Guide. 



Functions of the Transitional Monitor 

Control Card Interpretation Routine 

When the Transitional Monitor is brought into storage, 
one of its major functions is the interpretation of the 
Monitor control cards that define the next run or job. 
The Control Card Interpretation routine analyzes the 
Monitor control cards and, in accordance with their 
specifications, gives control to the System Monitor ele- 
ments required to prepare and execute the next run. 

Job Routine 

The Job routine prepares the Resident Monitor for the 
next job. This preparation includes resetting various 
program switches, clearing certain areas in the Com- 
munication Region, and canceling certain input/output 
unit assignments. 



Functions of the Linkage Loader 

The Linkage Loader converts relocatable subprograms 
into absolute format and, in the process, resolves com- 
munication symbols into machine addresses. 

Each Linkage Loader run produces a Job file, which 
contains program(s) in absolute format. Each program 
consists of all the subprograms to be executed as one 
program. A program on the Job file is brought into core 
storage by the Resident Monitor's Load routine when 
a Monitor control card requests execution of that 
program. 

Input to the Linkage Loader is from the Standard 
Input Unit, the Go file, and/or the System Library file. 
(These input/output files are discussed in the follow- 
ing topic, "Input/Output Files.") When several sub- 
programs are to be combined into a single program, the 
subprograms can be supplied to the Linkage Loader 
from any combination of the three input files, or they 
can all be from the same file. 

Selection of the subprograms to be converted into a 
single program is determined by control cards or by 
imbedded calls in the subprograms being processed. 

The Linkage Loader has the ability to incorporate 
patches or Snapshot requests into a previously com- 
piled subprogram. 



Input/Output Files 

The input/output files for the Operating System and 
the dependent programs running under it are divided 
into four categories: 

1. System Files. These input/output files, described 
below, are used by the System Monitor. 

2. Work Files. These tape, disk, or unit-record files 
are used by Operating System programs and can be 
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used by installation programs. The symbolic names for 
these files are: 

mwO ( Mw-zero ) through mw9 

mwa through mwz 

3. Reserve Files. These tape, disk, or unit-record files 
are reserved for use by installation programs. The sym- 
bolic names for these files are : 

mrO through mr9 
mra through MRZ 

4. Tele-Processing System Files. These tape, disk, or 
unit-record files are used by dependent programs that 
operate under control of the Tele-Processing Supervi- 
sor. The symbolic names for these files are: 

mtO through mt9 
mta through MTZ 

System Files 

SYSTEM OPERATING FILE 

The System Operating File contains Operating System 
programs in absolute format. This file contains the Sys- 
tem Monitor and can contain the language processors, 
the Utility programs, and the Sort Definition program. 

The System Operating File is created at System Gen- 
eration and is constructed according to the program 
requirements of each installation. When the file is cre- 
ated, the user may add user-written programs, such as 
an inventory or payroll program. 

The first element of the System Operating File is the 
Bootstrap routine, which initially loads the Resident 
Monitor into core storage. The following elements are 
IBM-supplied and installation components of the Op- 
erating System. 

The System Operating File may be on tape or disk. 
The symbolic name for this file is sof. 

SYSTEM LIBRARY FILE 

An installation can have any number of libraries of re- 
locatable programs, but only one is designated as the 
System Library file for a particular run of the Linkage 
Loader. 

A library may be on tape or disk. If it is on tape, it 
can be on the same tape as the System Operating File 
or it can be on a separate reel. The System Operating 
File tape can contain several libraries. If a library is on 
a separate tape, this tape can contain only one library. 
The symbolic name for the System Library file is lib. 

Libraries are created through use of the System 
Generation maintenance programs. (See the System 
Generation publication. ) 

STANDARD INPUT UNIT 

The Standard Input Unit contains the file of control in- 
formation for the System Monitor. Source programs for 
the language processors, relocatable programs to be 



processed by the Linkage Loader, and data and con- 
trol cards for dependent programs may also be placed 
in the Standard Input Unit. 

The Standard Input Unit can be a card reader or a 
magnetic tape unit. The symbolic name for the Stand- 
ard Input Unit is siu. 

Note: The term card means one 80-character input 
record. This record can be read either from an actual 
card, in installations that use a card reader for the 
Standard Input Unit, or it can be a tape record of 80 
characters. Tape files consisting of this type of record 
are said to be in card-image format. 

alternate input unit 

At the option of each installation, capability for using 
the Alternate Input Unit may be specified at System 
Generation. Control information can then be submitted 
to the System Monitor through either the Alternate or 
the Standard Input Unit. This configuration permits a 
high-priority job in the Alternate Input Unit to break 
into the previously established sequence of jobs in the 
Standard Input Unit. 

The Alternate Input Unit can be a card reader or a 
magnetic tape unit; it may be the same type of unit as 
the Standard Input Unit or it may be different. The 
type of unit for the Alternate Input Unit can be 
changed by a Monitor control card. The symbolic 
name for the Alternate Input Unit is aiu. 

Requests for changing from the Standard Input Unit 
to the Alternate Input Unit can be made between jobs 
through a console inquiry. 

standard print unit 

The Standard Print Unit is used for all printer output 

from ibm programs within the Operating System. 

Diagnostic messages for the programmer are written 

on this unit. It can also be used by the installation's 

programs. 

The Standard Print Unit can be either the ibm 1403 
Printer or a magnetic tape unit. If it is a tape unit, it 
can be the same unit as the Standard Punch Unit, 
which is described below. The symbolic name for the 
Standard Print Unit is spr. 

The Standard Print Unit can be omitted from a sys- 
tem; however, omission means that the programmer 
will not receive diagnostic messages or language proc- 
essor listings. 

standard punch unit 

The Standard Punch Unit is used for all punched-card 
output from ibm programs within the Operating Sys- 
tem. It is also available for use by the installation's 
programs. 

The Standard Punch Unit may be either the ibm 
1402 Card Read Punch or a magnetic tape unit. If it is 
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a tape unit, it can be the same unit as the Standard 
Print Unit. The symbolic name for the Standard Punch 
Unit is spu. This unit can be omitted from a system. 

When the Standard Punch and/or Standard Print 
Units are tape, the pow program can be used on an 
ibm 1401 to print and/or punch the tape records. When 
use of the pow program is specified at System Genera- 
tion, the Transitional Monitor writes the pow program 
as the first record on the tape when the tape is opened, 
either during initialization of the system or at the di- 
rection of the operator. ( The pow program is described 
in the Operator's Guide publication. ) 

JOB FILE 

The Job file is the output file of the Linkage Loader. It 
contains programs in absolute format. Job file proh- 
grams are loaded into storage by the Resident Monih 
tor's Load routine. 

The Job file must be assigned to the same type of dej- 
vice (tape or disk) as the System Operating File. The 
symbolic name for the Job file is mjb. | 

GO FILE 

The Go file contains relocatable programs compiled by 
the language processors. The Go file may contain on^ 
or more relocatable subprograms that were output 



from one or more language processor runs in the same 
job. The Go file serves as one of the input sources for 
the Linkage Loader. 

The Go file may be on tape or disk, as specified for 
each language processor during System Generation. 
The symbolic name for the Go file is mgo. 

CORE IMAGE FILE 

The Core Image file is used by the Resident Monitor 
to record the status of core storage at particular times 
during processing. This file is used by the Resident 
Monitor's End-of-Program routine each time an un- 
usual end of program occurs. ( The records written by 
the End-of-Program routine can later be used as input 
to the Utility program's Storage Print program, which 
edits and writes them on the Standard Print Unit. ) 

The Core Image file serves programs that use the 
iocs macro-instruction for writing checkpoint records. 
Checkpoint records can be used to restart a program 
that was temporarily interrupted. 

The Core Image file can also be used by dependent 
programs to log read errors. (See the Basic Input/ 
Output Control System publication. ) 

Use of the Core Image file is optional, but if it is in- 
cluded in an installation, it must be assigned to a tape 
unit. The symbolic name of the Core Image file is mdm. 
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Use of Linkage Loader 



The output from each of the language processors is in 
relocatable format to permit subprograms to be as- 
signed to any available area of core storage. The Link- 
age Loader assigns a subprogram to a particular area 
of storage in accordance with three factors: 

1. The size of the installation's Resident Monitor. 

2. The size and relative location of any other sub- 
programs to be loaded at the same time. 

3. Control information specifying predetermined 
storage assignments. 

Subprograms are compiled with address assignments 
relative to Absolute Zero (machine location 00000). 
That is, program instructions are compiled by the 
Autocoder and cobol language processors, from loca- 
tion 00000 upward or, by the Fortran processor, from 
location 00001 upward. The Autocoder processor can 
also compile from the origin point specified by an org 
card. 

Subprograms are relocated by the Linkage Loader 
relative to an address in core storage called Base Zero. 
Base Zero is the address of the location immediately 
above the last location occupied by the installation's 
Resident Monitor minus its Initialization routine. ( For 
installations that permanently reserve an area above 
the Resident Monitor for programs within a Tele- 
Processing system, Base Zero is the location immedi- 
ately above that reserved area.) Base Zero is, there- 
fore, the lowest location available to dependent pro- 
grams. Figure 2 illustrates the relationship of Absolute 
Zero and Base Zero. 
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Figure 2. Relationship of Base Zero to Absolute Zero 



When a subprogram is processed by the Linkage 
Loader, the subprogram's origin point is relocated in 
accordance with the installation's Base Zero. If, for ex- 
ample, the installation's Resident Monitor ended at lo- 



cation 10000, the Linkage Loader assigns an actual 
origin point of 10001 to the first subprogram it proc- 
esses. Other addresses contained in the subprogram are 
relocated accordingly. 

This type of relocation is termed upward relocation. 
Upward relocation is applied to the load addresses as- 
signed by the language processor to locate instructions 
and areas in core storage and to the reference ad- 
dresses in the A-fields and B-fields of the subprogram's 
instructions. Thus, the subprogram can be assigned to 
any area of core storage, yet interrelationship of the 
subprogram's elements is maintained. 

Note: The Linkage Loader will not permit a de- 
pendent program to overlay the Resident Monitor. If a 
load address, after relocation, is below Base Zero, the 
Linkage Loader will stop processing the program and 
will return control to the Resident Monitor. The Resi- 
dent Monitor will bring in the Transitional Monitor, 
which will resume processing with the next job. 

Upward relocation is the most common type of relo- 
cation used for a subprogram. However, the Linkage 
Loader performs two other types of relocation within 
subprograms. 

One of these is downward relocation. Where sepa- 
rately compiled subprograms are to share data areas, 
common data areas are used. These areas are located 
at the top of storage or at addresses specified by the 
programmer. Normally the specified address should be 
near the top of storage. The common data areas are 
addressed at the high-core position. When assigning 
addresses to common data areas, the language proc- 
essors, except Autocoder, arbitrarily designate 99999 as 
the top of storage. The Linkage Loader then relocates 
the addresses downward to the actual top of storage or 
to the specified location. 

The third type of relocation is NO relocation. The 
Linkage Loader does not relocate certain fixed ad- 
dresses, such as index register addresses. 

The value used by the Linkage Loader to perform 
upward relocation is called the upward relocation fac- 
tor. For the first subprogram in core storage, the re- 
location factor is equal to Base Zero; for succeeding 
subprograms in the same phase, the relocation factor is 
equal to Base Zero plus the size of all preceding sub- 
programs in that phase. 

The subprograms that form a given phase can be in 
any order in core storage; a primary subprogram need 
not be the first. 
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Note: During compilation, a character must be: 
placed in the highest location of a subprogram. (That 
is, a subprogram cannot end with an area into which 
nothing is loaded, such as an area defined by an Auto- 
coder da statement that does not set a group mark with: 
word mark in its highest position. ) Some character is 
necessary in the subprogram's highest location to en- 
able the Linkage Loader to properly relocate any fol- 
lowing subprograms. 

This requirement is automatically satisfied by the 
cobol and Fortran language processors. The require- 
ment can be met for an Autocoder compilation by a 
statement that defines a one-character constant in the 
subprogram's highest location. 



Control Cards for the Linkage Loader 

Control cards for the Linkage Loader direct processing 
during one execution of the Linkage Loader, rather 
than directing the general flow of processing during a 
batch. Linkage Loader control cards are not Monitor 
control cards; that is, they do not contain the identi- 
fication MON$$. 

The Monitor control card that initiates execution of 
the Linkage Loader must immediately precede the 
control cards for the Linkage Loader. The Linkage 
Loader determines that it has come to the end of its 
control cards when it finds a card that is not in a for- 
mat it recognizes. This card must be a Monitor control 
card. 

Figure 3 lists the Linkage Loader control cards, sum- 
marizes the important information about them, and 
shows their formats. 

CALL Card 

The operand of the call card is the name of the sub- 
program to be processed by the Linkage Loader. This 
card is used to request a subprogram from the System 
Library file or the Go file. A subprogram in the Stand- 
ard Input Unit does not require a call card; its title 
card serves the same function. When the Linkage 
Loader encounters a call card, it adds the specified 
name to a list of requests. When the Linkage Loader is 
ready to begin processing the subprograms on this re- 
quest list, it searches for them first in the Go file and 
then in the System Library file. 

This search is performed by reading the names of 
the programs on the Go file and the System Library file 
and comparing them with the names on the request 
list. This technique minimizes the time required for 
searching. 

Because the Linkage Loader uses this technique to 
minimize search time, the final sequence of subpro- 



grams in core storage is not necessarily the same as the 
call cards that requested the subprograms. (The 
calln and callp cards, described later, can be used to 
control the relative positioning of subprograms in core 
storage. ) 

For example, assume that the following subprograms 
are arranged sequentially on the System Library file: 
spI, sp2, sp3, sp4, and sp5. Assume also that call cards 
were read from the Standard Input Unit in the order: 
call sp3, call spI, call sp4. The Linkage Loader be- 
gins its search of the System Library file and locates 
the title card for spI. It checks this name against the 
names on the request list and finds that there is a re- 
quest for spI; therefore, it processes spI and places it 
on the Job file. The Linkage Loader then searches for- 
ward in the System Library file and locates the title 
card for sp2. It checks the request list, finds no request 
for sp2, and continues the search. The title card for 
sp3 is found in the Library and checked against the list. 
The Linkage Loader finds a request for sp3 and, there- 
fore, processes it and places it on the Job file behind 
spI. This procedure continues until all the subprograms 
on the request list have been located, processed, and 
placed on the Job file. 

The final sequence of subprograms would be spI, 
sp3, sp4 — the order in which they were located on 
the Library. (The relative location of subprograms in 
storage is referred to as the memory map. ) The reloca- 
tion factor for the three subprograms was adjusted as 
follows: spI was given an origin point of Base Zero, 
and all upward relocation for spI was performed with 
a relocation factor equal to Base Zero; sp3 was given an 
origin point of Base Zero plus the size of spI, and all 
upward relocation for sp3 was performed with a relo- 
cation factor equal to Base Zero plus the size of spI; 
sp4 was given an origin point of Base Zero plus the 
combined size of spI and sp3, and all upward reloca- 
tion for sp4 was performed with a relocation factor 
equal to Base Zero plus the combined size of spI and 
sp3. 



imbedded calls 

In addition to requests for subprograms specified by 
call cards, Autocoder language dcws, dcwf, and call 
cards are requests for subprograms. Because these 
cards are within subprograms, this type of request is 
termed an imbedded call. 

When the Linkage Loader encounters an imbedded 
call, it checks its symbol table for the name of the 
called subprogram. If it finds the name, the sub- 
program has already been processed, since its title 
card established the name as a linkage symbol. Then 
the Linkage Loader replaces the imbedded call, for a 
dcws card, with a branch to the address assigned to 
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Location in 
Control Card 
Deck 


Format 


Functions 


Remarks 


6 15 


16 Card 20 
Type 


21 Operand(s) 


Beginning of first 
phase in program 




PHASE 


PROGMNAME1 


Terminates the previous phase, be- 
gins a phase, causes all previous 
calls to be processed. Defines 
PROGMNAME1 as the name of 
the program. 


Erases linkage symbols from 
Linkage Loader symbol 
table. 

Columns 60 through 70 must 
be blank. 


Beginning of 
succeeding phase 




PHASE 




Beginning of 
succeeding phase 
(user-specified 
phase number) 


005 


PHASE 






User specification of succeeding 
phase number, which must be 
in ascending order, need not be 
sequential, and may not be 
blanks or 999. Columns 60 
through 70 must be blank. 


Immediately before 
BASE1 or PHASE 
card; anywhere 
within a subprogram 
except between TITLE 
and BASE1 cards 




PRTCT 
PRTCT 
PRTCT 
PRTCT 


LINKSYMBOL 

ABCD/ 

15000 


Keeps Linkage Loader from 
erasing linkage symbols with 
addresses equal to or higher than 
operand. Blank-operand card 
removes the protection. 


Protection is changed by another 
PRTCT card and is effective only 
for the current Linkage Loader 
run. 


Immediately after 
TITLE card (if sub- 
program is on System 
Library file and is to 
be relocated to same 
point each time) or 
immediately after 
PHASE card or 
PHASE andPRTCT 
cards 




BASE1 
BASE1 
BASE1 


LINKSYMBOL 

ABCD/ 

15000 


Replaces current relocation 
factor with address for the link- 
age symbol or with absolute 
address in operand. 


Erases from Linkage Loader 
symbol table linkage symbols 
with a value equal to or 
higher than the BASE1 value 
but less than PRTCT value. 


BASE1 


*+X00 


Sets current relocation factor 
to next higher address that is a 
multiple of 100 


BASE! 




Sets relocation factor to Base Zero. 


Within control cards 
for a phase or within 
a subprogram 




CALL 


SUBPGNAME2 


Calls subprogram from System 
Library or Go file when all calls 
are collected. 




Within control cards 
for a phase 




CALLN 


SUBPGNAME2 


Causes all previous calls to be 
processed, then brings in called 
subprogram from System Library 
or Go file. 




Within control cards 
for a phase 




CALLP 


SUBPGNAME2 


Causes all previous calls to be 
processed, then brings in called 
subprogram from System Library 
or Go file and adds patches to 
called subprogram. 


Patch cards must immediately 
follow CALLP card. (See 
"Program Patching" section 
for patch card formats.) 


Before subprogram 
affected is processed or, 
within a subprogram, 
after TITLE card, but 
before any cards re- 
ferring to common data 
area 




BASE2 
BASE2 
BASE2 


LINKSYMBOL 

ABCD/ 

15000 


Sets upper limit of common data 
area to address for the linkage 
symbol or to absolute address in 
operand. 


This downward relocation 
factor applies to all suc- 
ceeding subprograms 
during the current Linkage 
Loader run or until the 
next BASE2 card. 




BASE2 




Sets upper limit of common 
data area to top of core . 


First card of sub- 
program 




TITLE 


SUBPGNAME2 

xxxxx 

YYYYY 

NOTE: Leave 
five blanks be- 
tween XXXXX 
and YYYYY. 


Begins a subprogram. Defines 

SUBPGNAME2 as a linkage 

symbol. 

YYYYY = Size of common data 
area subprogram will 
use. 

XXXXX= Origin for subprogram 
expressed as an ab- 
solute address. 


NOTE: This TITLE card 
format is in the relocatable 
object deck produced by 
the language processors; 
it is not the same format 
as the Autocoder symbolic 
TITLE card. 



Figure 3. Control Cards for Linkage Loader ( Page 1 of 2 ) 
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Location in 
Control Card 
Deck 


Format 


Functions 


Remarks 


6 15 


16 Card 20 
Type 


21 Operand(s) 


Within a 
subprogram 


ABCD/ 
LINKSYMBOL 


DEFIN 
DEFIN 


LINKSYMBOL 
15000 


Defines the linkage symbol 
in columns 6 through 15 for 
use by the Linkage Loader 
as an entry point or data 
field within a subprogram. 


Can be coded directly in the 
Autocoder language. See the 
Autocoder publication for 
full details. 


After subprogram 
requested but be- 
fore the Linkage 
Loader symbol 
table is erased and 
before the end of 
the phase 


IDE NT 


SNAP 


SUBPGNAME2 
xxxxxyyyyy 
zzzzzyyyyy 
zzzzzss 

NOTE 1 : Do not 
put commas be- 
tween operands. 

NOTE 2: ss must 
be in columns 
56 and 57 . 
Therefore, if only 
one area is to be 
snapped, leave 
blanks for the 
second 
yyyyyzzzzz. 


Requests Snapshots of storage 
during execution of the sub- 
program. Causes all previous 
calls to be processed. 
IDENT is any one to five char- 
acters to identify the 
Snapshot listing, 
xxxxx = Relocatable address 
of instruction before which 
the Snapshot is to be 
taken, 
yyyyy = Relocatable address of 
lower limit of area to be 
snapped, 
zzzzz = Relocatable address of 
upper limit of area to be 
snapped, 
ss = Length of instruction 
at xxxxx; if the instruction 
length is less than ten, it 
should be written with a 
zero in column 56, 


Cannot be used in a compile- 
and-go operation. 

Instruction before which 
Snapshot is to be taken must 
be at least seven characters 
long, cannot be chained, and 
cannot be in pn IOCS macro- 
instruction. 

NOTE: When relocating the ad- 
dresses on the SNAP card, the 
Linkage Loader will add the 
value for the subprogram name 
linkage symbol to the relocatable 
addresses in the SNAP card. 
Therefore, if the subprogram 
was origined at other than 00000, 
subtract the origin value from 
the compiled addresses to get 
the addresses to be used on the 
SNAP card. 


Anywhere within 
control cards for 
Linkage Loader 




INPUT 
INPUT 


Mxx 
SIU 


Directs Linkage Loader to read 
control cards from a unit other 
than the one being read. 


Mxx is the name of a currently 
assigned symbolic unit, such as 
MR1 . End of file on the substitute 
unit causes a return to the 
Standard Input Unit, as does an 
INPUT card with the operand 
SIU. (See the section "Assign- 
ment of Input/Output Units.") 


Before CALLN, 
CALLP, PHASE, SNAP, 
or Monitor control cards 
or end of file on Standard 
or Alternate Input Unit 




DISGO 




Go file will not be searched 
for subprograms. 


Effective during current Linkage 
Loader run or until next 
CONGO card. 


Anywhere after 
DISGO card 




CONGO 




Cancels DISGO card function. 




PROGMNAME1 is the linkage symbol that is the program name defined by the PHASE card. 
SUBPGNAME2 is the linkage symbol that is the subprogram name defined by the TITLE card. 
LINKSYMBOL is any linkage symbol. 

All three of these linkage symbols consist of one to ten characters that are left-justified, with trailing blanks in a ten-position field. 
ABCD/ is any five-character linkage symbol. 



Figure 3. Control Cards for Linkage Loader ( Page 2 of 2 ] 
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the linkage symbol or, for a dcwf card, with a five- 
character constant of that address. 

If the called subprogram has not yet been processed, 
the Linkage Loader places the subprogram name on its 
request list. (The same request list is used for call 
card requests. ) When the Linkage Loader later locates 
and processes the subprograms on this list, it supplies 
the previous imbedded calls with the branch addresses 
or constants. 

Note 1 : Autocoder provides the deein statement for 
establishing linkage symbols to represent any point in 
a subprogram. ( The linkage symbol established by the 
title card of a subprogram represents the origin point 
of that subprogram. ) Linkage symbols established by 
the defin statement can also appear in dcwf and dcws 
cards; these cards are treated by the Linkage Loader 
in the same manner as dcwf and dcws cards that con- 
tain a subprogram name. However, note that a sub- 
program is located and processed only if it has been 
called by the name contained in its title card. There- 
fore, if subprogram anyname contains an entry point 
represented by the linkage symbol abcdefghij, the 
card dcws abcdefghij cannot be completely processed 
unless a call is made for anyname, either by a call 
card or an imbedded call. 

Note 2: The linkage symbols established within a 
particular phase of a multiphase program can be re- 
ferred to by subprograms within the same phase and 
succeeding phases, but they cannot be referred to in 
preceding phases. For example, Phase 1 cannot contain 
a dcws card with the linkage symbol work/ if that 
symbol is not established by a title card or Definition 
card until Phase 2. 

Organization of programs should be planned with 
special care regarding imbedded calls. Imbedded calls, 
if not ordered properly, could cause additional 
searches of the System Library file and, therefore, be 
time consuming. 

The following rules apply to calling programs: 

1. Rules of precedence for memory maps are: 

a. The first subprograms in core storage will be 
those read from the Standard Input Unit (in 
the order read ) . 

b. The second group of subprograms in core stor- 
age will normally be those read from the Go 
file ( in the order read ) . 

c. The third group of subprograms in core stor- 
age will normally he those read from the Sys- 
tem Library file ( in the order read ) . 

d. If the subprograms in items b and/or c contain 
imbedded calls, then item c will be repeated 
until all calls are completed. The Go file is not 
searched again. 

2. Imbedded calls are considered to be for sub- 



programs in the System Library file. If the subprogram 
requested by an imbedded call is on the Go file, it must 
also be requested by a call card that is not imbedded 
in a subprogram. 

Note: The call card may be omitted if the re- 
quested subprogram follows the requesting subpro- 
gram on the Go file. 

3. The Go file is reset to its beginning and searched 
if any subprogram names are on the request list when 
the Linkage Loader reads a calln, callp, phase, snap, 
or Monitor control card, or finds the end of file on the 
Standard or Alternate Input Unit. 

Note: The disgo card can be used to prevent this 
search of the Go file. 

4. Subprograms placed in the Standard or Alternate 
Input Unit do not require a call card; their title 
cards serve this function. 

5. If a subprogram on the Go file is to replace a sub- 
program with the same name on the System Library 
file, and the subprogram is requested by an imbedded 
call, a call card should be used to guarantee loading 
the subprogram from the Go file. 

example 1 

This example illustrates the procedure for directing the 
Linkage Loader to process a subprogram from the Sys- 
tem Library file. The subprogram (spI) constitutes a 
self-contained, single-phase program that has no im- 
bedded calls for other subprograms. 

Only one control card is necessary: call spI. The 
Linkage Loader will locate spI on the Library, process 
it, and place it on the Job file. 

example 2 

This example illustrates the procedure for directing the 
Linkage Loader to construct a single-phase program 
from three subprograms: spI, sp2, and sp3. (One of the 
three must be a primary subprogram; the other two 
can be primary or secondary. ) In this example, spI is 
on the System Library file, sp2 is in the Standard Input 
Unit, and sp3 is on the Go file. None of the subpro- 
grams contain imbedded calls. 

The sequence of cards in the Standard Input Unit is 
as follows: 

call spI 

title card and relocatable object deck for sp2 

call sp3 

The Linkage Loader proceeds as follows: 

1. call spI: The name of spI is placed on the re- 
quest list. 

2. title card and relocatable object deck for sp2: 
sp2 is processed and the name sp2 is added to the re- 
quest list, with a flag indicating that sp2 has been 
processed. 
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3. call sp3: The name sp3 is added to the request 
list. The Linkage Loader resumes reading from the 
Standard Input Unit and finds no more Linkage 
Loader control cards. It begins searching the Go file, 
locates sp3, and processes it. Next, the Library is 
searched. spI is located and processed. 

The memory map is shown below. The area between 
the outer vertical lines represents the area of core stor- 
age used for the subprograms processed. 



SP2 


SP3 


SPI 



EXAMPLE 3 

This example illustrates the construction of a single- 
phase program from three subprograms, one of which 
is processed because of an imbedded call. spI is on the 
System Library file and contains an imbedded call for 
sp3; sp2 is on the Go file. 

The sequence of cards in the Standard Input Unit is 
as follows: 

call spI 

CALL SP2 

The Linkage Loader proceeds as follows: 

1. call spI: The name spI is placed on the request 
list. 

2. call sp2: The name sp2 is placed on the request 
list. The Linkage Loader resumes reading from the 
Standard Input Unit and finds no more Linkage 
Loader control cards. It begins searching the Go file, 
locates sp2, and processes it. Next, the Library is 
searched. spI is located and processed. During the 
processing of spI, the Linkage Loader finds the im- 
bedded call for sp3. At that time, the name sp3 is 
placed on the request list. When the processing of spI 
is completed, the Linkage Loader checks the request 
list, finds the unsatisfied request, and resumes the 
search of the Library. sp3 is located and processed. 

The memory map is as follows : 



SP2 


SPI 


SP3 



CALLN Card 

The function of the calln card (Call Now) is essen- 
tially the same as the call card, except that the calln 
card directs the Linkage Loader to locate and process 
the specified subprogram immediately. This card can 
be used to control the memory map. 

When the Linkage Loader reads a calln card, it 
does the following: 

1. All subprograms specified by previous call cards 
are located and processed. 

2. Any imbedded calls resulting from processing 



these subprograms are also processed (except im- 
bedded calls for the subprogram named in the calln 
card). 

3. Then the subprogram specified by the calln card 
is processed. 

4. Any imbedded calls resulting from processing the 
subprogram specified by the calln card are added to 
the request list for subprograms ( if the imbedded calls 
have not been satisfied by processing already 
performed ) . 

The following rules apply to the use of the calln 
card: 

1. Rules of precedence for memory maps: 

a. All subprograms called before the subprogram 
named by the calln card will be the first sub- 
programs in core storage. (The relative order 
of those subprograms is determined in accord- 
ance with the rules of precedence for the call 
card. ) 

b. The subprogram named by the calln card will 
be placed in core storage following the sub- 
programs specified in item a, above. 

2. The name of a subprogram on the Standard Input 
Unit should never be the operand of a calln card. If 
the preceding calls should be processed before a sub- 
program on the Standard Input Unit, the calln card 
should be used to call the last preceding subprogram. 

example 1 

This example illustrates the construction of a single- 
phase program from four subprograms that must be 
positioned in a certain order. Three subprograms are 
on the System Library file and the fourth is in the 
Standard Input Unit. None of them contain imbedded 
calls. The sequence of subprograms on the Library is 
spI, sp2, sp3; sp3 must be positioned in storage after 
spI and before sp2 and sp4. 

The sequence of cards in the Standard Input Unit is 
as follows: 

CALL SPl 
CALLN SP3 
CALL SP2 

title card and relocatable object deck for sp4 
The Linkage Loader proceeds as follows: 

1. callspI: The name spI is placed on the request 
list. 

2. calln sp3: The name sp3 is stored, but not 
placed on the request list. The Linkage Loader begins 
searching for previously called subprograms. It locates 
spI on the Library and processes it. The Linkage 
Loader then determines that the request list has been 
satisfied. (spI was the only name on the list.) The 
name sp3 is moved to the request list. sp3 is then lo- 
cated and processed. 
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3. callsp2: The name sp2 is placed on the request 
list. 

4. title card and relocatable object deck for sp4: 
The Linkage Loader processes sp4. It resumes reading 
from the Standard Input Unit and finds no further 
Linkage Loader control cards. sp2 is then located and 
processed. 

The memory map is as follows : 



SPl 


SP3 


SP4 


SP2 



EXAMPLE 2 

This example illustrates the construction of a single- 
phase program from three subprograms, one of which 
contains an imbedded call for a subprogram that must 
be placed between the other two subprograms. 

The three subprograms are on the System Library 
file in the order spI, sp2, sp3. sp3 must be positioned 
after sp! and before sp2; spI contains an imbedded call 
for sp3. 

The sequence of cards in the Standard Input Unit is 
as follows : 

call spI 

CALLN SP3 

CALL SP2 

The Linkage Loader proceeds as follows : 

1. call spI: The name spI is placed on the re- 
quest list. 

2. calln sp3: The name sp3 is stored but not placed 
on the request list. The Linkage Loader begins search- 
ing for previously called subprograms. It locates spI 
on the Library and processes it. During the processing 
of spI, the Linkage Loader finds the imbedded call for 
sp3. The Linkage Loader will supply the imbedded call 
in spI with the address of sp3 when the title card of 
sp3 is processed. The Linkage Loader then determines 
that there are no more names on the request list, moves 
sp3 to the request list, locates sp3, and processes it. 

3. call sp2: The name sp2 is placed on the request 
list. The Linkage Loader resumes reading from the 
Standard Input Unit and finds no more Linkage Loader 
control cards. sp2 is then located and processed. 

The memory map is as follows : 



SPl 


SP3 


SP2 



CALLP Card 

The callp card ( Call and Patch ) functions in the same 
manner as the calln card. The callp card also directs 
the Linkage Loader to incorporate patches into the 
specified subprogram. The patches, in relocatable 



machine-language form, must immediately follow the 
callp card in the Standard Input Unit. (See the sec- 
tion, "Program Patching," for patch card formats.) 

PHASE Card 

phase cards are used to create a multiphase program 
and to assign a name to that program. Each time the 
Linkage Loader encounters a phase card it performs 
the following functions: 

1. All previous calls (from both control cards and 
imbedded calls) are processed. The Linkage Loader 
gives the resulting phase a termination record, which 
indicates the entry point of that phase if it included a 
primary subprogram. ( This information is used by the 
Load routine of the Resident Monitor to initiate execu- 
tion of the phase after it has been loaded into core 
storage. ) 

2. The Linkage Loader creates a header record for 
the next phase, consisting of the name and number of 
the phase. 

The first phase card for a multiphase program must 
specify the name of that program. Succeeding phase 
cards for the same program must have blank operand 
fields. For the first phase card, the Linkage Loader 
generates a header record, containing the name speci- 
fied in the operand, and a phase number of 001. For 
succeeding phase cards of the same multiphase pro- 
gram, the Linkage Loader generates a header record, 
containing the name specified by the first phase card, 
and a phase number determined by incrementing a 
counter each time a phase card with a blank operand 
is encountered. Therefore, the first phase card with a 
blank operand indicates the beginning of the program's 
second phase, and the header record for this phase 
contains the phase number 002. 

The programmer can specify the phase number, for 
any phases after the first phase, by putting a three- 
digit phase number (other than 999) in columns 6 
through 8 of a blank-operand phase card. This phase 
number must be higher than the last phase number 
assigned; otherwise the Linkage Loader will ignore 
the user-assigned number and will assign the next 
sequential number to the phase. Following a user- 
assigned phase number, the next blank-operand phase 
card without a user-assigned number will be assigned a 
phase number one higher than the user-assigned 
phase number. 

The following rules apply to the use of the phase 
card: 

1. A phase card must immediately precede each 
group of Call cards ( call, calln, callp ) that specify 
the subprograms to be included in that phase. 

2. If the first phase card is omitted, the name of the 
first subprogram that is processed is vised by the Link- 
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age Loader as the name of the entire multiphase pro- 
gram. The header record of each phase will have this 
name. A single-phase program that consists of mote 
than one subprogram should have a phase card if the 
program is relocated and executed in the same jo[b. 
Because the subprograms are not necessarily processed 
in the order they are called, the phase card is needed 
to set the program name for the Monitor control card 
that executes the program. 

3. A phase card with a program name in the operand 
field causes the Linkage Loader to reset the relocation 
factor to Base Zero and to erase from the Linkage 
Loader's symbol table any linkage symbols left froim 
processing previous subprograms. (This erasure of 
symbols can be controlled by use of the prtct card, 
which is described later. ) 

4. A phase card with a blank operand field does not 
reset the relocation factor, nor does it cause the erasure 
of any symbols from the symbol table. 

5. Columns 60 through 70 of the phase card must be 
left blank. (These columns are used by the Linkage 
Loader. Their contents are defined in the System 
Generation publication. ) 

example 

Because the phase card is most commonly used with 
the baseI card, examples illustrating phase card u$e 
follow the baseI card description. 



BASEI Card 

The baseI card is used to control the relocation factor. 
This control of the relocation factor enables the pro- 
grammer to direct the Linkage Loader to relocate ; a 
phase in such a manner that it will overlay the preced- 
ing phase at a predetermined point. 

Three types of operands can be used in a baseI 
card: 

1. Linkage Symbol: If a linkage symbol appears in 
the operand of a baseI card, the Linkage Loader se:ts 
the relocation factor to the address equated with thjat 
symbol in the Linkage Loader's symbol table. For this 
reason, the linkage symbol must be defined by a sub- 
program processed before the one that includes tllie 
base! card. In most cases, the linkage symbol is de- 
clared by the title card of a previous subprogram. 
Using a subprogram name as a baseI operand enables 
one phase of a program to be relocated to the origin 
point of a subprogram in a previous phase even though, 
at the time the baseI card was coded, the actual origin 
point of the previous subprogram had not yet be$n 
determined. When the phase that included the bas^I 
card is loaded into core storage, it will overlay the 
previous phase, beginning at the origin point of the 
subprogram named in the operand of the baseI card. 

Note: Because Autocoder provides the defin state- 



ment defining linkage symbols other than the origin 
point of a subprogram, Autocoder users can construct 
phases that overlay preceding phases at locations other 
than the beginning of a subprogram. 

2. Actual Address: If the operand of a baseI card 
contains an actual address, the Linkage Loader sets the 
relocation factor to that address. Care must be exercis- 
ed in the use of this operand, because the final location 
of program elements that preceded a baseI card con- 
taining an actual address cannot always be predicted. 

3. *-\-X00: If the operand of a baseI card contains 
*-{-X00 (asterisk-plus sign-X-zero-zero ) , the Linkage 
Loader sets the current relocation factor to the next 
highest address that is a multiple of 100. (If the re- 
location factor is already a multiple of 100, no adjust- 
ment is performed. ) This operand is not necessarily 
related to a multiphase program. It is provided to 
control the relocation of subprograms that depend on 
certain areas being located at an even-hundred ad- 
dress. ( For example, use of the Autocoder Clear Stor- 
age instruction can result in this requirement.) 

Each time the Linkage Loader encounters a baseI 
card, it performs the following functions: 

1. It sets the relocation factor to the address value 
specified by the operand of the baseI card. 

2. It erases from the symbol table all linkage sym- 
bols equated to addresses higher than the address value 
specified by the operand of the baseI card. ( This era- 
sure occurs only for baseI cards with a symbol or 
actual address in the operand. The *+X00 operand 
does not cause symbols to be erased. ) The erasure of 
symbols can be controlled by the prtct card, which is 
described later. 

The following rules apply to the use of the baseI 
card: 

1. A baseI card, when placed in the Standard or 
Alternate Input Unit, should immediately follow a 
phase card. A baseI card will affect all subprograms 
that have not been processed, even if the calls for those 
subprograms preceded the baseI card. (A prtct card 
can be inserted between the phase card and baseI 
card. ) 

2. If a baseI card appears in a subprogram, it must 
appear immediately after the title card. This location 
is required for subprograms that are on the System 
Library file and are to be relocated to the same point 
each time. 

3. The address value of a linkage symbol used as the 
operand of a baseI card must have been defined during 
processing of a previous subprogram. 

example 1 

This example illustrates the construction of a two- 
phase program from two subprograms. spI constitutes 
the first phase of the multiphase program, and sp2 
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constitutes the second phase, which is to overlay the 
first completely. Both subprograms are on the System 
Library file. Neither of the subprograms contains im- 
bedded calls. 

The sequence of cards in the Standard Input Unit is 
as follows: 



PHASE 
CALL 



SAM 

sp! 



PHASE 

BASEl SPl 

CALL SP2 

The Linkage Loader proceeds as follows: 

1. phase sam: A header record is created. It con- 
tains the name sam and the phase number 001. 

2. call spI : The name spI is placed on the request 
list. 

3. phase ( blank operand ) : All previous calls are 
processed. (In this example, spI is the only previous 
call.) A termination record is generated for the first 
phase; a header record is generated for the second 
phase. It contains the name sam and the phase num- 
ber 002. 

4. baseI spI: The relocation actor, which is not 
affected by a blank-operand phase card, is set to the 
address value esablished by the title card of spI. (All 
linkage symbols with an address equal to or higher 
than the title card address are erased from the sym- 
bol table. ) 

5. call sp2: The name sp2 is placed on the request 
list. The Linkage Loader resumes reading from the 
Standard Input Unit and finds no more Linkage Loader 
control cards. sp2 is located and processed. 

The memory maps are as follows : 



Phase 1 



Phase 2 




baseI 


sp2 


call 


sp3 


CALL 


sp4 


CALL 


sp5 



The Linkage Loader proceeds as follows: 

1. phase matilda: A header record is created. It 
contains the name matilda and the phase number 001. 

2. call spI: The name spI is placed on the request 
list. 

3. calln sp2: In accordance with the procedure for 
calln cards, spI is located and processed, then sp2. 

4. phase (blank operand): A termination record is 
generated for the first phase. It contains the entry 
point specified by the Termination card of whichever 
subprogram was the primary one. A header record is 
generated for the second phase. It contains the name 
matilda and the phase number 002. 

5. baseI sp2: The relocation factor is set to the ad- 
dress value established by the title card of sp2. (All 
linkage symbols with an address value equal to or 
higher than the title card address are erased from 
the symbol table. ) 

6. call sp3: The name sp3 is placed on the request 
list. 

7. call sp4: The name sp4 is placed on the request 
list. 

8. call sp5: The name sp5 is placed on the request 
list. The Linkage Loader resumes reading from the 
Standard Input Unit and finds no further Linkage 
Loader control cards. sp3, sp4, and sp5 are located on 
the Library and processed. 

The memory maps are as follows: 



Phase 1 



Phase 2 



SPI 



SP2 



SPI 


SP3 


SP4 


SP5 



EXAMPLE 2 

This example illustrates the construction of a two-phase 
program from five subprograms. spI and sp2 constitute 
the first phase and sp3, sp4, and sp5 constitute the 
second phase, which is to overlay only sp2 of the 
first phase (leaving spI in storage). All the subpro- 
grams are on the System Library file. None of them 
contain imbedded calls. 

The sequence of cards in the Standard Input Unit is 
as follows: 



PHASE 


MATILDA 


CALL 


SPl 


CALLN 


sp2 



EXAMPLE 3 

This example illustrates the construction of two sep- 
arate multiphase programs during a single run of the 
Linkage Loader. All subprograms are on the System 
Library file, and none of them contain imbedded calls. 
The sequence of cards in the Standard Input Unit 
is as follows: 



PHASE 


OLSEN 


CALL 


SPl 


PHASE 




BASEl 


spI 


CALL 


sp2 


PHASE 


JOHNSON 
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CALL 


SP3 


PHASE 




BASEl 


sp3 


CALL 


sp4 



The Linkage Loader proceeds as follows : 

1. phase olsen through call sp2: The Linkage 
Loader begins construction of a two-phase program 
in the manner illustrated by the preceding examples. 

2. phase johnson: The request list is checked lor 
outstanding calls. The Linkage Loader finds the name 
sp2 on that list (from the call sp2 card), locates ahd 
processes sp2, and generates a termination record lor 
the preceding phase. The relocation factor is then reset 
to Base Zero, and linkage symbols are erased from the 
symbol table. A header record is generated for the 
next phase. It contains the name johnson and the 
phase number 001. 

3. call sp3 through call sp4: The Linkage Loader 
constructs the second multiphase program. 

The memory maps are as follows: 



Phase 1 



Phase 2 



Phase 1 



Phase 2 



Program OLSEN 
SP1 



SP2 



Program JOHNSON 
SP3 



SP4 



Note: The two programs are not necessarily related 
in any way. This example is designed to illustrate a 
means of directing the Linkage Loader to produce a 
Job file that is, in effect, a library of programs in abso- 
lute format. 

PRTCT Card 

The PRTCT card is used to limit the erasure of linkage 
symbols from the symbol table. The Linkage Loadier 
will retain in its symbol table all linkage symbols with 
addresses equal to or higher than the address valjie 
specified by the operand of the prtct card. The 
operand of a prtct card can be either a linkage symbol 
or an absolute address. This protection will be Re- 
tained until it is changed by another prtct card or by 
the initialization performed each time the Linkage 
Loader is brought into storage for execution. 

The following rules apply to the use of the prtct 
card : 

1. The prtct card must precede any control card 
that would cause erasure of symbols higher than the 



address value specified by the operand of the prtct 
card. 

2. The address value of a linkage symbol used as 
the operand of a prtct card must have been defined 
during the processing of a previous subprogram in the 
same execution of the Linkage Loader. 

example 

This example illustrates construction of a two-phase 
program in which one subprogram must be placed in 
upper storage and be used by other subprograms in 
both phases. All of the subprograms are on the System 
Library file, and none of them contain imbedded calls. 
The sequence of cards in the Standard Input Unit 
is as follows: 



phase 


OTHELLO 


CALL 


SPl 


CALLN 


sp2 


BASEl 


30000 


CALL 


sp3 


PHASE 




PRTCT 


30000 


BASEl 


sp2 


CALL 


sp4 



The Linkage Loader proceeds as follows: 

1. phase Othello through calln sp2: spI and sp2 
are processed as explained in previous examples. 

2. baseI 30000: The relocation factor is set to 30000. 
(Note that all previous calls have been satisfied be- 
cause of the calln card. Note also that if sp2 had con- 
tained an imbedded call for a subprogram that had not 
yet been processed, the new relocation factor would 
be applied to that subprogram.) 

3. call sp3: The name sp3 is placed on the request 
list. 

4. phase (blank operand): sp3 is located and proc- 
essed. A termination record is generated for the first 
phase. A header record is generated for the second 
phase. It contains the name othello and the phase 
number 002. 

5. prtct 30000 : The Linkage Loader notes that link- 
age symbols equated to an address value of 30000 and 
higher are not to be erased from the symbol table. 
( The operand of the prtct card could also be sp3. ) 

6. baseI sp2: The relocation factor is reset to the 
address value established by the title card of sp2. 
Linkage symbols equated to an address value higher 
than sp2 and lower than 30000 are erased from the 
symbol table. 

7. call sp4: sp4 is placed on the request list. The 
Linkage Loader resumes reading from the Standard 
Input Unit and finds no more Linkage Loader control 
cards. sp4 is located and processed. 

The memory maps are as follows: 
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Phase 1 



30000 



SP1 SP2 



SP3 



Phase 2 



30000 



SP1 SP4 



SP3 



BASE2 Card 

The operand of the base2 card, which can be either a 
linkage symbol or an absolute address, sets the upper 
limit of a common data area. 

Each time the Linkage Loader encounters a base2 
card, it sets the downward relocation factor. This factor 
is then used for the adjustment of addresses that refer 
to a common data area. 

The following rules apply to use of the base2 card: 

1. The base2 card must be positioned in the Stand- 
ard Input Unit so that it is read before the processing 
of any subprograms affected by it. The base2 card can 
also be placed within a subprogram, but before any 
references to a common data area. 

2. More than one base2 card can be used, but rule 
1 also applies to the additional cards. 

3. If a linkage symbol is used for the operand of a 
base2 card, the address value of that symbol must have 
been defined during the processing of a previous sub- 
program. 

4. The base2 limit will apply for all succeeding sub- 
programs processed in the Linkage Loader run, unless 
changed by another base2 card. 

example 

This example illustrates the construction of a single- 
phase program from three subprograms, each of which 
refers to a common data area. All three subprograms 
are on the System Library file, and none of them con- 
tain imbedded calls. 

The sequence of cards in the Standard Input Unit 
is as follows: 



base2 


38000 


CALL 


spI 


CALL 


sp2 


CALL 


sp3 



The Linkage Loader proceeds as follows : 

1. base2 38000: The factor for downward relocation 
is set to 38000. 

2. call spI through call sp3: These three subpro- 
grams are located and processed. During processing, 
all references to the common data area are adjusted in 
accordance with the factor set by the base2 card. 

The memory map is as follows : 



SPI 


SP2 




| 38000 | 


SP3 





Common 

Data 

Area 






Top of Core 

SNAP Card 

The snap card directs the Linkage Loader to include 
the Snapshot program in a specified subprogram. ( The 
Snapshot program is one of the Utility programs pro- 
vided in the Operating System. See the Utility Pro- 
gram publication for a description of the Snapshot 
program. ) 

The operands used in this card are as follows: 
suBPRGNAMExxxxxyyyyyzzzzzyyyyyzzzzzss 
Where: 

subprgname is the one- to ten-character subprogram 
name, left-justified, with trailing blanks in a ten- 
position field, 
xxxxx is the address of the instruction immediately be- 
fore which a Snapshot is to be taken. 
yyyyy * s tne address of the lower limit of an area for 
which a Snapshot is to be taken. This address, if 
not an even hundred, will be changed to an even 
hundred by the Snapshot program, which replaces 
the units and ten positions with zeros, 
zzzzz is the address of the upper limit of an area for 
which a Snapshot is to be taken. This address, if 
not an address ending in 99, will be changed by 
the Snapshot program, which replaces the units 
and tens positions with 99. 
ss is the length of the instruction at location xxxxx. If 
the instruction length is less than 10, it should be 
written as a two-digit number with a leading zero, 
e.g., 07. 
Note 1: ss must be in card columns 56 and 57. 
Therefore, if only one area is to be snapped, leave 
blanks for the second yyyyyzzzzz. 

Note 2: Do not put commas between operands. 

The addresses used as operands are the relocatable 
addresses for a program compiled from 00000 upward. 
Normally these addresses can be obtained from the 
listing of the compilation. The Linkage Loader will 
add the value equated to the subprogram name link- 
age symbol to the addresses specified in the operand 
field of the snap card. However, if the subprogram was 
origined at other than 00000, the user must subtract 
the origin value in the Autocoder org card or must 
subtract 1 for a Fortran program from the compiled 
addresses to get the addresses to be used on the snap 
card. 

Columns 6 through 10 of the snap card can be used 
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to establish a one- to five-character identification for 
the Snapshot(s) specified by the card. Any characters 
in those columns will be printed on the Snapshot 
listing. 

The instruction at the point where the Snapshot; is 
to be taken must be at least seven characters long, 
cannot be chained, and cannot be part of an ides 
macro-instruction. 

The following rules apply to use of the snap card: 

1. A snap card must be positioned in the Standard 
Input Unit after the subprogram that it affects, or the 
call for that subprogram, but before the subprogram's 
name is erased from the Linkage Loader symbol table 
and before the end of the phase. 

2. Any number of snap cards can be submitted be- 
tween phase cards. 

3. A snap card can contain either one or two sets of 
upper and lower limits for Snapshot areas. 

4. A snap card forces all pending calls for sub- 
programs. 

5. The Snapshot program must be in the Resident 
Monitor or in the library designated as the System 
Library file for this Linkage Loader run. 

The snap card can be used only with a program 
that has been compiled. For a compile-and-go opera- 
tion requiring Snapshot listings, use a Snapshot calling 
sequence in the source program. This sequence is 
given in the Utility Programs publication. 

The Linkage Loader will replace the instruction be- 
fore which the Snapshot is to be taken with a branch- to 
a sequence that links to the Snapshot routine. The re- 
placed instruction will appear in the linkage sequence, 
which is placed after the named subprogram. 

INPUT Card 

The input card can be used to direct the Linkage 
Loader to read its control cards and relocatable object 
decks from a source other than the Standard Input 
Unit. The operand of the input card is the name of the 
symbolic unit to be substituted for the Standard Input 
Unit. 
The following rules apply to use of the input card: 

1. The name of the substituted symbolic unit must 
be one that is currently assigned to a physical unit. (See 
the section, "Assignment of Input/Output Units.") 

2. End of file at the substitute unit causes the Link- 
age Loader to resume reading from the Standard Input 
Unit. 

3. input cards can be placed at any point in the 
control card deck for the Linkage Loader. 

4. The input card can contain the operand: siu. In 
this case, the Linkage Loader resumes reading frbm 
the Standard Input Unit. Such a card would be used! in 
a substitute unit, after an input card in the Standard 



Input Unit had directed the Linkage Loader to begin 
reading from that substitute unit. 

Note: The term Standard Input Unit, as used in the 
above description, refers to the unit currently used by 
the Monitor as its source of control information. This 
source could be either the Standard or Alternate Input 
Unit. 



TITLE Card 

The title card is the first card of each subprogram. It 
defines the name of the subprogram as a linkage sym- 
bol. It is compiled by the Autocoder, Fortran, and 
COBOL language processors. The format for the title 
card is: 

TITLE SUBPRGNAMEyyyyy xxxxx 

Where subpgrname is the one- to ten-character sub- 
program name. (If less than ten characters, it is 
left-justified with trailing blanks in a ten-position 
field.) 
yyyyy is the base to which the subprogram was com- 
piled. This is normally 00000 or blank for Auto- 
coder and cobol programs. (If blank 00000 is 
assumed by the Linkage Loader.) It is 00001 for 
Fortran programs, 
xxxxx is the total number of core locations in the com- 
mon data area required by this subprogram. 
Note: Five blanks separate yyyyy and xxxxx. 
The value expressed by yyyyy, which is the low 
origin point for the subprogram, is subtracted from the 
current upward relocation value to produce the reloca- 
tion factor for this subprogram. 

The value expressed by xxxxx, the common data 
area size, is added to each relocated load address to 
determine if core storage has been exceeded. If stor- 
age is exceeded, the Linkage Loader prints the 
message core exceeded on the Standard Print Unit. 
This is only a warning message; the Linkage Loader 
will put the subprogram that exceeded storage on the 
Job file and, if requested by an exeq card, the sub- 
program will be executed. 

After the Linkage Loader reads a title card, it will 
read the next card in order to determine if it is a base! 
card. If so, the baseI card will be processed before the 
title card. 

The title cards generated by the cobol and For- 
tran processors contain additional operands, which 
are not used by the Linkage Loader. 

DISGO Card 

The disgo card specifies that the Go file is not to be 
searched for called subprograms. This card should be 
used to save search time when all called subprograms 
are on the System Library file. 
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After the Linkage Loader reads the disgo card, it 
will not search the Go file ( 1 ) for the rest of the cur- 
rent Linkage Loader run, or (2) until a congo card 
is read. 

The disgo card is needed because the calln, callp, 
phase, snap, and Monitor control cards, and the end 
of file on the Standard or Alternate Input Unit, cause 
the Linkage Loader to process all calls on its request 
list. For this processing, the Linkage Loader rewinds 
the Go file and searches it from the beginning. 

When a disgo card is in effect, the Go file must 



remain mounted, ready, and assigned by an asgn card. 
( For details about the asgn card, see the "Assignment 
of Input/Output Units" section.) 

CONGO Card 

The congo card cancels the effect of the disgo card. 
Thus, in the next search after the congo card, the Go 
file will be searched. 

The congo card is required only if a disgo card has 
been used because, if a disgo card is not used, the Go 
file is searched once in each search. 
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Use of Resident Monitor Functions 



Resident Monitor functions can be used through link- 
age sequences and system symbol references coded 
into a source program. 

The linkage sequences are branch instructions and, 
usually, one or more fields of control information. The 
branch instruction gives control to a routine in the 
Resident Monitor. The linkage sequences are listed in 
Figure 4. 

Macro-instructions to generate most of the link- 
age sequences are included in the Autocoder Macro 
Library. These macro-instructions are given in this 
section after the corresponding linkage sequence 
descriptions. 

The system symbols refer to areas of the Communi- 
cation Region, so that all dependent programs can use 
certain information stored in the Resident Monitor. 
System symbols referring to areas in the Communica- 
tion Region are listed in Figure 5. 



Use of Communication Region 

Contents of the Communication Region 

Information in the Communication Region can be used 
by any dependent program at any time. However, the 
information can be modified only through the linkage 
sequence described below. 

Some Communication Region fields contain data; 
others contain an address constant that gives the loca- 
tion of an area or data. 

Each area of the Communication Region contains a 
word mark in its high-order position only. 

Modification of the Communication Region 

To modify a field of the Communication Region, the 
dependent program must contain a linkage sequence 
constructed as follows: 

BXPA /MCR/ 

DCW /XXX/ 

dcw (low-order address of information to be 

placed in Communication Region field 

/xxx/) 
dcw (address of dependent program routine 

to be given control if field cannot be 

modified ) 
(Next sequential instruction in dependent pro- 
gram) 



An example of the need for a dependent program to 
modify a Communication Region field is modification 
of the /ipi/ field during one program to set a switch 
for a later program in the same job. The following 
Autocoder macro-instruction can be used to generate 
the linkage sequence for modification of a Communi- 
cation Region field. 

anylabel monop MODiFY,xxx,yyyyy,zzzzz 
modify operand: must appear as shown. 
xxx operand: the system symbol, without slashes, 

for the Communication Region 
field to be modified. 
yyyyy operand : the low-order address of the infor- 
mation to be placed in the Com- 
munication Region field, 
zzzzz operand: optional. This is the address to 
which control is to be given if 
the Communication Region field 
cannot be modified. If this oper- 
and is omitted, control will be 
returned to the next sequential 
instruction after the macro-in- 
struction. 



Use of Unit-Record Routines 

The three unit-record routines in the Resident Monitor 
can be used by dependent programs. One of these 
routines reads from the Standard or Alternate Input 
Unit, another writes on the Standard Print Unit, and 
the third writes on the Standard Punch Unit. 

All three routines perform their functions with un- 
blocked records, in Move mode. If tape is used for 
any of the routines, the unit-record functions are per- 
formed in odd parity, and the records are unblocked. 

Read Routine 

The Read routine reads 80-character records from the 
Standard or Alternate Input Unit. ( In constructing the 
linkage sequence to the Read routine, the programmer 
makes no distinction between reading from the Stand- 
ard or Alternate Input Unit.) 

The high-order address of the input area last filled 
by the Read routine is placed in the /crd/ field in the 
Communication Region, /ced/ must be used to retrieve 
information from an input area. The input areas are 
in the Resident Monitor. Word marks must not be set 
or cleared in the input areas. 
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Resident Monitor Functions 

Read Routine: Reads 80-character 
records from Standard Input Unit and 
Alternate Input Unit 



Print Routine: Writes 132-character 
records on Standard Print Unit 



BBE 
NSI 



Linkage Sequence in 
Autocoder Language 

/RSI/ 

(address of end-of-file routine 

in dependent program) 

USERERROR,/MCS/,n 



Where the contents of n must be : 
by the user. 



elected 



Punch Routine: Punches 80-character 
records on Standard Punch Unit 



Console Inquiry Routine: Clears /MCI/ 
to blank, informs operator of need for 
information, enters waiting loop until 
operator has typed input, and returns 
control to NSI. 



Wait-Loop Routine 



Load Routine: Locates and loads a 
phase on the Job file or System 
Operating File (as specified on the 
EXEQ card for the program). 



Subroutines of Load Routine: 

Backspace System Tape: Backspaces 
records on the Job file or System 
Operating File (as specified on the 
EXEQ card for the program) . 

Read System Tape: Reads one rec- 
ord from the Job file or System 
Operating File (as specified on the 
EXEQ card for the program) . 



Rewind System Tape: Closes and 
opens, with rewind and label 
checking if applicable, the 
Job file or System Operating 
File (asspecifiedon the EXEQ 
card for the program) . 

4. Simple Search of System Tape: 
Locates the requested phase 
of the program currently being 
executed. 



One outpu 


t area: 


BXPA 
DCW 


/PRT/ 
#5 


OCW 


(high-order address of 


NSI 


output area) 


Tv/o outpu 
BXPA 
DCW 


areas: 
/PRT/ 
#5 


DCW 


(high-order address of 



output area) 

(high-order address of other 

output area) 



One outpu 


t area: 


BXPA 
DCW 


/PCH/ 

#5 


DCW 


(high-order address of 


NSI 


output area) 


Two outpu 


areas: 


BXPA 
DCW 


/PCH/ 

#5 


DCW 


(high-order address of 



Nsr 



BXPA 
DCW 
DCW 
DCW 

IOCTL 

BCE 

NSI 



output area) 
(high-order address of 
other output area) 

/MCR/ 
/MCI/ 

(address of a blank) 
(address of dependent pro- 
gram's error routine) 
TYPE, MESSAGE 
* -11, /MCI/ 



/WAT/ 



Locate, load, and execute phase: 
B AOD/ 

DCW +nnn 

Locate and load phase: 
B /LOD/ 

DCW -nnn 
NSI 

nnn = phase number of a phase of the 
program being executed. 



ZA 


(number of records to be back- 




spaced, minus one),X13 


B 


/ZBS/ 


NSI 




BXPA 


/ZRR/ 


DCW 


(@L@ for Load mode or @M@ 




for Move mode) 


DCW 


(input area address) 


BBE 


USSERERROR,/ZRS/,n 


NSI 





Where the contents of n must be selected 
by the user. 

B /ZRW/ 



B /ZSS/ 

DCW (three-position unsigned phase 

number) 
DCW (address of dependent program 

routine to be given control if 

phase is not found). 
NSI 



Remarks 



/MCS/ contains the Channel Status Character constructed by the 

Resident IOCS from any machine indicators turned on by read 

errors. 

The Channel Status Character is described in the Basic Inpu t/ 

Output Control System publication. 



Output areas defined by dependent program, 134 positions long 

1. First position. Carriage-control character. (See Figure 6.) 

2. Positions 2 through 133. Record to be written on 

Standard Print Unit. (If tape, first character is also written.) 

3. Position 134. Group mark with word mark. 



Output areas defined by dependent program, 81 positions long: 
1 . Positions 1 through 80. Record to be punched by 

Standard Punch Unit. 
2. Position 81 . Group mark with word mark. 



High-order position of input message area is designated by /RIQ/ 
Operator identifies input message with$3x. x is placed in /MCI/. 
MESSAGE is the label for the console printer message, coded 
in the dependent program, that informs the operator of the need 
for the S3x message. 



Console inquiry message, $50, causes the Resident Monitor to 
exit from the Wait-Loop routine and return control to NSI. 



The fourth instruction is optional. It will give control to a 
dependent program error routine (USERERROR). /ZRS/ contains 
the Channel Status Character constructed by the Resident 
IOCS from any machine indicators turned on by read errors. 



Figure 4. Linkage Sequences for Use of Resident Monitor Functions ( Page 1 of 2 ) 
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Resident Monitor Functions 



Read System Disk: Reads one 
record in load mode from the 
Job file or System Operating 
File (asspecifiedon the 
EXEQ card for the program) 
into an input area. 



End-of-Program Routine 



Modification of Communication 
Region Routine 



Linkage Sequence in 
Autocoder Language 



Read Specific [Track: 
BPXA /fRR/ 
DCW @JN@ 

BBE U5ERERROR,/ZRS/,n 

NSI 

Read Next Track: 
BXPA /ZRR/ 

DCW (four-character track address) 
BBE USERERROR,/ZRS/,n 

NSI 

Where the contents of n must be selected 
by the user. 



Normal End of Program: 
B /EOP/ 

Unusual End of Program: 
B /UEP/ 

Special End of. Program: 

BXPA /MCR/ 

DCW /CGO/ 

DCW (address of an A bit) 

DCW (address of dependent program 
routine to be given control 
if field cannot be modified) 



NOTE: NSI is usually 
B /EOP/. 



BXPA /MCR/ 

DCW /XXX/ 

DCW (low-order address of informa- 
tion to be placed in field 
/XXX/) 

DCW (address of dependentlprogram 
routine to be given control 
if field cannot be modified) 



Remarks 



Input area defined by Resident Monitor: High-order position 
is/MBF/. Low-order data position (one position left of 
terminating group mark with word mark) is /MBX/. 



USERERROR is the label of an error routine in the dependent 
program. /ZRS/ contains the Channel Status Character 
constructed by the Resident IOCS from any machine indicators 
turned on by read errors. 



NSI is the next sequential instruction in the dependent program. 

Figure 4. Linkage Sequences for Use of Resident Monitor Functions ( Page 2 of 2 ) 
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System 

Symbol Contents of Field 


Contents 
Type 


Length 


Modi- 
fiable 


System 

Symbol Contents of Field 


Contents 
Type 


Length 


Modi- 
fiable 


/AMS/ Actual machine size minus two (highest lo- 
cation that can be loaded by the Load 
routine). For example, for a machine with 
80,000 positions of core storage, this field 
would contain 79997. This field is filled 
in at System Generation. 


Address 
Constant 


5 


No 


/PHN/ Phase number of program phase currently be- 
ing executed. (This area is set to 001 at 
each Monitor EXEQ card.) 


Data 


3 


No 


/PNM/ Name of program currently being executed. 
(The name is left-justified in the area.) 


Data 


10 


Yes 


/SIZ/ Highest location loaded for the current 

dependent program (including any previous 
phases of it). This field is set by the 
Resident Monitor's Load routine. 


Address 
Constant 


5 


Yes 


/CRD/ Contains the high-order address of the 
input area last filled by the Resident 
Monitor's Read routine. 


Address 
Constant 


5 


No 


/DAT/ Date (first two positions for the year, fol- 
lowed by three positions for the day) . This 
area is set by a Monitor control card dur- 
ing initialization of the Resident Monitor. 
(See the section, "Use of Transitional 
Monitor. ") 


Data 


5 


No 


/TPB/ Lowest location of the area reserved for 
programs under control of the Tele- 
Processing Supervisor. (Tele-Processing 
Systems are described in the Tele- 
Processing Supervisor publication.) This 
location is also the top of the Resident 
Monitor minus the Initialization routine. 


Address 
Constant 


5 


No 


/I PI/ Interprogram information. (This area can 
be used to store control information be- 
tween runs within a job. For example, a 
program can set switches in this area that 
can be tested by the next program exe- 
cuted.) This area is set to blanks between 
each job. 


Data 


5 


Yes 


/MCI/ Set by console inquiry $3x, where x is 
placed in /MCI/. It is set to blank by 
End-of-Program routine. 


Data 


1 


Yes 


/MGA/ Contains track address of last track on 
disk Go file. 


Disk 
Address 


4 


Yes 


/LIN/ Number of lines per page for printer out- 
put. This field is set at System Genera- 
tion. (This field can be reset by any 
program that wishes to establish a con- 
stant that can be compared to a program 
counter for its printer output. However, 
any program that resets this field must 
set it back to the original value before 
end of program.) 


Data 


2 


Yes 


/CGO/ Go and other indicators. The A bit ON 
indicates that the contents of the Go 
and Job files are not valid. The B bit 
ON indicates that a language processor 
should put its output on the Go file. The 
B bit OFF indicates that the Go file 
contents are not valid. 
These indicators are set by the language 
processors, Linkage Loader, Monitor 
MODE control card, and dependent 
programs. Both bits are turned OFF be- 
tween jobs. 


Data 


1 


Yes 


/ORG/ Contains lowest location of storage area 
available to dependent programs. (This 
field, which is set at System Generation , 
is used by the Linkage Loader to determine 
the value of Base Zero.) This location is 
at the top of the Resident Monitor minus 
the Initialization routine or at the top of 
the area reserved for programs under con- 
trol of the Tele-Processing Supervisor, if 
such an area exists. 


Address 
Constant 


5 


No 



Figure 5. System Symbols for Communication Region Fields 



The Read routine checks each input record to deter- 
mine whether it is a Monitor control card. If it is, the 
routine branches to the dependent program's end-of- 
file address specified in the linkage sequence. There- 
fore, input records for a dependent program must not 
contain mon$$ in columns 6 through 10. 

The Resident iocs checks for all read errors. 

The linkage sequence for use of the Read routine is 
as follows: 

B /RSl/ 

b (address of end-of-file routine in depend- 

ent program ) 

BBE USERERROR,/MCS/,n 

(Next sequential instruction in the dependent 
program ) 
If the Read routine signals an end-of-file condition, 
it returns control to the branch instruction containing 
the address of the dependent program's end-of-file 
routine. Otherwise, control is returned to the third 
instruction in the linkage sequence. (The third instruc- 
tion, as shown, is optional.) 



A program using the Read routine can also check 
for read errors by including the third instruction, as 
shown. This instruction interrogates /mcs/. /mcs/ con- 
tains the Channel Status Character constructed by the 
Resident iocs from any machine indicators turned on 
by read errors. The Channel Status Character is de- 
scribed in the Basic Input/Output Control System 
publication. 

usererror in the third instruction is the address to 
which control is to be given if an error occurred. The 
contents of n, which must be selected by the user, will 
be compared to /mcs/ to determine if control should 
be given to usererror. 

The following Autocoder macro-instruction can be 
used to generate the linkage sequence to the Resident 
Monitor's Read routine. 



anylabel stdio 
read operand: 
area operand: 



READ,AREA,EOFADDR,USERERROR,n 

must appear as shown, 
the high-order address of an 81- 
position field, which includes 
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eofaddr operand: 



usererror operand: 



n operand: 



a group mark with word 
mark at the end, into which 
the record is to be moved. 
This area must be defined by 
the dependent program. 

the address in the dependent 
program to which control is 
to be given when end of file 
occurs. 

optional. The address in the de- 
pendent program to which 
control is to be given if an 
error occurs. 

optional. The character to 
which /mcs/ will be com- 
pared to determine if control 
should be given to user- 
error. The user must select 
the contents of n. 



d 


IMMEDIATE 
SKIP TO 


d 


SKIP AFTER 
PRINT TO 


d 


IMMEDIATE 
SPACE 


1 


Channel 1 


A 


Channel 1 


blank 


1 Space 


2 


: Channel 2 


B 


Channel 2 


K 


2 Spaces 


3 


Channel 3 


c 


Channel 3 


L 


3 Spaces 


4 


Channel 4 


D 


Channel 4 






5 


Channel 5 


E 


Channel 5 










6 

7 
8 


Channel 6 
Channel 7 
Channel 8 


F 
G 
H 


Channel 6 
Channel 7 
Channel 8 


d 


SPACE AFTER 
PRINT 


/ 


1 Space 


9 


Channel 9 


1 


Channel 9 


S 


2 Spaces 





Channel 10 


? 


Channel 10 


T 


3 Spaces 


# 


Channel 11 


• 


Channel 1 1 






@ 


Channel 12 


□ 


Channel 12 







Figure 6. Carriage-Control Characters for Print Routine 



Print Routine 

The Print routine writes 132-character records on the 
Standard Print Unit. The Print routine can be 
addressed by two types of linkage sequences. One 
requests a print operation using one-area logic; the 
other requests a print operation using two-area logic. 
Both linkage sequences include the address of the out- 
put area(s) containing the record(s) to be written on 
the Standard Print Unit. 

Note: Only one record will be written per entry to 
this routine. 

Each output area must be defined by the dependent 
program, and each must be 134 positions long. The 
first position of the area is used to specify the carriage- 
control character. ( See Figure 6 for the carriage-con- 
trol characters.) Positions 2 though 133 of the output 
area contain the record to be written on the Standard 
Print Unit. ( If the Standard Print Unit is tape, the first 
position of the output area is also written ) Position 
134 of the output area must contain a group mark with 
word mark. 

The; two types of linkage sequences for using the 
Print routine are as follows. 

One Output Area: 

bxpa /prt/ 

dcw #5 

dcw (high-order address of the output area) 

(Next sequential instruction in the dependent 
program ) 

Two Output Areas: 

bxpa /prt/ 

DCW #5 

dcw ( high-order address of one output area ) 



dcw (high-order address of the other output 

area) 
(Next sequential instruction in the dependent 
program ) 
Note: The dcw of five blanks (immediately below 
the branch instruction) is used for internal functions 
of the Print routine. This field must be included in 
every linkage sequence to the Print routine. 

By testing for a word mark in the position immedi- 
ately following the dcw that contains the address of 
the output area, the Print routine determines which 
type of linkage sequence is being used. If a word mark 
is present, it is assumed to be the word mark over the 
operation code of the next instruction in the dependent 
program. If no word mark is present in that position, 
as with the dc, the Print routine assumes the presence 
of an address for a second output area. 

Note: If only one output area is specified, the posi- 
tion following the address of the output area must con- 
tain a word mark. 

If two output areas are specified, the Print routine 
first uses the output area originally specified by the 
dcw. After completion of each print operation, the 
routine rotates the two addresses in the linkage se- 
quence. Before the first print operation, the linkage 
sequence would appear as follows: 
bxpa /prt/ 
dcw #5 
dcw xxxxx 

dc yyyyy 

After the first print operation, the linkage sequence 
would appear as follows: 
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BXPA 


/prt/ 


DCW 


#5 


DCW 


yyyyy 


DC 


xxxxx 



The next time the Print routine is addressed by this 
linkage sequence, it will use the output area repre- 
sented by yyyyy. After that print operation is com- 
pleted, the two addresses are rotated again. 

If the printed output is to start on a new page, the 
first data record must have a "1" as the carriage-control 
character. If the last data record of the printed output 
is to be the last line printed on a page, one additional 
record of blanks, with a "1" as the carriage-control 
character, should follow the last data record. 

The Resident iocs checks for all print errors (or 
write-tape errors, if tape is used), except for wrong- 
length records. 

The following Autocoder macro-instruction can be 
used to generate the linkage sequence to the Print 
routine : 

ANYLABEL STDIO PRINT, ARE A 1, ARE a2 

print operand: must appear as shown. 

areaI operand: the high-order address of a 134- 

position field from which the 
record is to be printed. The 
first position of the field 
specifies the carriage-control 
character (Figure 6). Po- 
sitions 2 through 133 contain 
the record to be printed. Po- 
sition 134 contains a group 
mark with word mark. 

area2 operand: optional. This operand specifies 

a second output area with 
the same format as areaI. 

Punch Routine 

The information concerning the Print routine also 
applies to the Punch routine, with the following 
exceptions : 

1. The Punch routine writes 80-character records on 
the Standard Punch Unit. The output area(s) for 
these records must be 81 positions long. (Position 81 
must contain a group mark with word mark. ) 

2. The system symbol used in the bxpa instruction 
is /pea/. 

The following Autocoder macro-instruction can be 
used to generate the linkage sequence to the Punch 
routine: 

ANYLABEL STDIO PUNCH,AREAl,AREA2 

punch operand: must appear as shown. 

areaI operand: the high-order address of an 

81-position field from which 



the record is to be punched. 

Position 81 must contain a 

group mark with word mark. 

area2 operand: optional. This operand specifies 

a second output area with 
the same format as areaI. 

The Resident iocs checks for all punch errors (or 
write-tape errors, if tape is used), except wrong-length 
record. 



Use of Console Inquiry Routine 

Through the Console Inquiry routine, a dependent 
program can request input from the console printer, 
enter a waiting loop while the operator types in the 
information, and then retrieve the input. 
The linkage sequence for console input is: 
bxpa /mcr/ 

DCW /MCl/ 

dcw ( address of a blank ) 

dcw (address of dependent program's error 

routine ) 

ioctl type,message 

bce *-11,/mci/ 

( Next sequential instruction in the dependent pro- 
gram. This instruction should move the console 
input from /riq/ to a field in the dependent 
program. ) 

message is the label for a console printer message 
coded in the dependent program. This message is 
typed to request that the operator enter a $3x message. 
Then the sequence enters a waiting loop that is broken 
when the $3x message is entered. 

The typed-in message begins with $3x. The x is 
moved to a one-character field designated /mci/. /mci/ 
is cleared to blank by the Console Inquiry routine, 
before it requests the input, and by the End-of-Pro- 
gram routine. 

The high-order position of the console input area is 
designated /riq/. The input area length is defined at 
System Generation; it can be five positions minimum 
to 20 positions maximum. In a Tele-Processing system, 
the input message area must be 20 positions long. 
Wrong-length-record errors are ignored by the Console 
Inquiry routine. 

The input area is not cleared by the Console Inquiry 
routine. Because a following console message might 
overlay the $3x message, the dependent program 
should immediately move the message from the input 
message area and compare the $3x in the message to 
the x in /mci/ to verify that the message retrieved is 
the correct one. 
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Use of Wait-Loop Routine 

When a dependent program requires that processing 
be suspended until the machine operator performs a 
function (such as changing forms in the printer), the 
program can write a message on the console printer 
and then enter the Wait-Loop routine. When the oper- 
ator has performed the function specified by the pro- 
gram's message, he breaks the waiting loop by means 
of console inquiry $50. The Resident Monitor then 
returns control to the dependent program at the in- 
struction immediately following the branch to the 
Wait-Loop routine. 

The entry point to the Wait-Loop routine is repre- 
sented by the system symbol /wat/, In Autocoder, the 
instruction b /wat/ is used to enter the routine. cobol 
generates this branch from the stop ( literal ) statement. 
Fortran generates this branch from the pause state- 
ment. 

In a Tele-Processing system, the system can receive 
interrupts during the waiting loop. 



Use of Load Routine 

The Load routine in the Resident Monitor can be used 
by dependent programs to locate and load phases of a 
multiphase program. 

The linkage sequence to request locating, loading, 
and execution of a specific phase is as follows: 
b /lod/ 

dcw -f-nnn 
When the phase number, nnn, contains a plus sign 
over the units position, the Load routine initiates exe- 
cution of the phase at its entry point. 

The linkage sequence to request only locating and 
loading of a specific phase is as follows: 
b /lod/ 

dcw — nnn 

(Next sequential instruction in dependent pro- 
gram) 
When the phase number, nnn, contains a minus sign 
over the units position, the Load routine returns con- 
trol to the next sequential instruction following the 
linkage sequence that issued the request for the phase. 
The following considerations should be observed ill 
using linkage sequences to request program phases : 

1. Requests can be issued only for phases of the pro- 
gram being executed. (The name of the program being 
executed is contained in the /pnm/ field of the Com- 
munication Region. ) 

2. The number of the phase being executed is con- 
tained in the /phn/ field of the Communication Re- 
gion. Using this field, the dependent program can 
construct a request for a specific phase in relation to 
the phase being executed. 



3. If the requested phase cannot be located, control 
is given to the Resident Monitor's End-of-Program 
routine at the unusual-end-of -program entry point. The 
requested phase must be on the System Operating File 
or Job file, as specified in the exeq card for the pro- 
gram. (Details concerning end-of -program procedures 
are in the topic, "Use of End-of-Program Routine." 
Details on the exeq card are in the section, "Use of 
Transitional Monitor." ) 

4. As a phase is brought into storage, it overlays all 
information in the previous phase that falls inside the 
new phase's lowest and highest loading addresses. 
Therefore, information to be communicated from one 
phase to the next must reside below the lowest address 
into which information is loaded for a succeeding 
phase, or above the highest address. 

For a tape-oriented Resident Monitor, dependent 
programs can use subroutines in the Load routine to 
read, backspace, rewind, and search the Job file or 
System Operating File, whichever was specified in the 
Monitor exeq control card for the program. For a disk- 
oriented Resident Monitor, dependent programs can 
use a subroutine in the Load routine to read the Job 
file or System Operating File, whichever was specified 
in the exeq card for the program. 

Read System Tape Subroutine 

This subroutine reads the next record from the Job file 
or System Operating File into the area designated in 
the linkage sequence. The input area must be defined 
by the dependent program. Wrong-length-record er- 
rors are not checked. If the subroutine detects the 
end of file, the file will be rewound and opened with 
label checking, if labels exist, and the first data record 
after the label will be read into the designated area. 

The linkage sequence for the Read System Tape 
subroutine is : 

bxpa /zrr/ 

dcw (@l@ for Load mode or @m@ for 

Move mode) 

dcw (input area address) 

BBE USERERROR,/ZRS/,n 

(Next sequential instruction in the dependent 
program ) 

The fourth instruction is optional. It will give con- 
trol to a dependent program error routine labeled 
usererror if an error occurred. The user must select 
the contents of n to match the error conditions to be 
checked, /zrs/ contains the Channel Status Character 
constructed by the Resident iocs from any machine 
indicators turned on by read errors. 

The following Autocoder macro-instruction can be 
used to generate the linkage sequence to the Read Sys- 
tem Tape subroutine: 
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ANYLABEL SYSIO READ,X,AREA,USERERROR,n 

read operand: must appear as shown. 

x operand: must be an L for Load 

mode or an M for Move 
mode. 

area operand: the high-order address of 

the area into which the 
record is to be read. This 
area must be defined by 
the dependent program. 

usererror operand: optional. This is the ad- 
dress in the dependent 
program to which control 
is to be given if an error 
occurred. 

n operand: optional. This is the char- 

acter used for compari- 
son to determine if an 
error occurred. The user 
must select the contents 
of n. 

Backspace System Tape Subroutine 

This subroutine backspaces one or more records, as 
specified in the linkage sequence, on the Job file or 
System Operating File. The subroutine will backspace 
over tape labels, treating them as data records. 

The linkage sequence for the Backspace System 
Tape subroutine is: 

za (number of records to be backspaced, 

minus one ) , X13 

B /ZBS/ 

(Next sequential instruction in the dependent 
program ) 
The following Autocoder macro-instruction can be 
used to generate the linkage sequence to the Back- 
space System Tape subroutine: 

ANYLABEL SYSIO BSP,X 

bsp operand: must appear as shown. 
x operand : the number of records to be back- 
spaced, minus one. 

Rewind System Tape Subroutine 

This subroutine closes and opens, with rewind and 
label checking if applicable, the Job file or System 
Operating File, whichever was specified in the exeq 
card for the program. 

The linkage sequence for the Rewind System Tape 
subroutine is: 

B /ZRW/ 

(Next sequential instruction in the dependent 
program ) 



The following Autocoder macro-instruction can be 
used to generate the linkage sequence to the Rewind 
System Tape subroutine: 

ANYLABEL SYSIO RWD 

rwd operand: must appear as shown. 

Simple Search of System Tape Subroutine 

This subroutine locates but does not load the requested 
phase of the program being executed. It will not search 
for phases of other programs. If the phase is not lo- 
cated, control is transferred to the not-found address 
specified in the linkage sequence. 

The linkage sequence for the Simple Search of Sys- 
tem Tape subroutine is : 

B /ZSS/ 

dcw ( three-position unsigned phase number ) 
dcw (address of dependent program routine 
to be given control if phase is not 
found ) 
(Next sequential instruction in dependent pro- 
gram) 
The following Autocoder macro-instruction can be 
used to generate the linkage sequence to the Simple 
Search of System Tape subroutine: 

ANYLABEL SYSIO SEARCH,nnn,NOTFNADDR 

search operand : must appear as shown. 

nnn operand: the three-digit unsigned 

number of the phase to 
be found. 

notfnaddr operand: optional. This is the ad- 
dress in the dependent 
program to which con- 
trol is to be given if the 
phase is not found. If 
omitted, control will be 
returned to the instruc- 
tion after the macro-in- 
struction. 



Read System Disk Subroutine 

This subroutine reads a record from the System Oper- 
ating File or Job file in a disk-oriented Operating Sys- 
tem. The subroutine reads in Load mode. The input 
area is defined by the Resident Monitor; the high-order 
position is /mbf/ and the low-order position ( one posi- 
tion to the left of the terminating group mark with 
word mark) is /mbx/. 

The linkage sequence for the Read System Disk sub- 
routine for a specific track ( to be read from the System 
Operating File or Job file, whichever is specified in the 
exeq card) is: 



34 



BXPA /ZRR/ 

dcw ( four-character track address ) 

BBE USERERROR,/ZRS/,n 

(Next sequential instruction in dependent pro- 
gram) 
The linkage sequence to read the next track from 
the System Operating File or Job file, whichever is 
specified in the exeq card, is : 
bxpa /zrr/ 

DCW @N@ 

BBE USERERROR,/ZRS/,n 

(Next sequential instruction in dependent pro- 
gram ) 

usererror is the label of an error routine in the 
dependent program, /zrs/ contains the Channel Status 
Character constructed by the Resident iocs from any 
machine indicators turned on by read errors. The user 
must select the contents of n to match the error con- 
ditions to be checked. 

The following Autocoder macro -instruction can be 
used to generate the linkage sequence to the Read Sys- 
tem Disk subroutine. The forms of the macro-instruc- 
tion to read a specific or the next track are: 

ANYLABEL SYSIO READ„nnnn,USERERROR,n 
ANYLABEL SYSIO READ,„USERERROR,n 

read operand: must appear as shown. 

Commas: must appear as shown. 

nnnn operand: if present, this operand 

specifies the four-digit 
track address of the rec- 
cord to be read. If omit- 
ted, the next sequential 
track will be read. (Omis- 
sion must be indicated 
by a comma, as shown in 
the second form above.) 

usererror operand: optional. This is the ad- 
dress in the dependent 
program to which con- 
trol is to be given if an 
error occurred. 

n operand: optional. This is the char- 

acter used for compari- 
sons to determine if an 
error occurred. The user 
must select the contents 
of n. If a comma or com- 
mercial at sign (@) is 
used for this operand, 
write it as follows: 
For a comma: @,@ 
For the at sign: 



Use of End-of -Program Routine 

Dependent programs can end execution in one of three 
ways: normal end of program, unusual end of pro- 
gram, or special end of program. The results of the 
three end-of-program types are summarized below. 



END OF PROGRAM NOT TEST MODE 



Normal entry 
point: /eop/ 



Special entry 
point: /eop/; 
a bit of 
/cgo/ ON 



Continue process- 
ing with the next 
Monitor control 
card. 

Skip to next job 
card. 



Unusual entry 
point: /uep/ 



Write contents of 
storage on Core 
Image file, if this 
file was specified at 
System Generation. 
Skip to next job 
card. 



test mode 

Continue process- 
ing with the next 
Monitor control 
card. 

Continue process- 
ing with the next 
Monitor control 
card. However, 
Linkage Loader 
will not be loaded 
and executed and 
programs on the 
Job file will not be 
executed, if re- 
quested. 

Write contents of 
storage on Core 
Image file, if this 
file was specified at 
System Generation. 
Continue process- 
ing with next Mon- 
itor control card. 



The mode is determined by the mode card (de- 
scribed in the section, "Use of Transitional Monitor"). 

Note: As the Transitional Monitor skips to the next 
job card, it will process Monitor control cards directed 
to the Tele-Processing system and will process a Mon- 
itor end card. 

Normal End of Program 

When a dependent program completes its required 
functions, it signals end of program by branching to 
the Resident Monitor at the entry point represented 
by the system symbol /eop/. This linkage sequence in 
Autocoder language is b /eop/. The Resident Mon- 
itor brings the Transitional Monitor into storage to 
read the Standard or Alternate Input Unit for the next 
Monitor control card. 

Note: The next Monitor control card can be a con- 
trol card indicating the beginning of the next job or 
requesting the performance of another run within the 
current job (such as the execution of a Utility pro- 
gram ) . Therefore, within one job, the Resident Monitor 
can receive any number of end-of-program indications. 

Unusual End of Program 

An unusual end of program can be signaled to the Res- 
ident Monitor in one of two ways: by the dependent 
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program, itself, or by the console inquiry, $10, from 
the operator. The linkage sequence to the unusual-end- 
of -program portion of the End-of -Program routine is: 

B /UEP/. 

When the Resident Monitor receives an unusual- 
end-of -program indication, it preserves the contents of 
storage on the Core Image file (if the installation in- 
cludes such a file ) . The Resident Monitor then checks 
to determine if the dependent program is being tested, 
as indicated by a mode card. If the test mode is not 
on, the Resident Monitor cancels any subsequent por- 
tions of the current job by bringing the Transitional 
Monitor into storage to read the Standard or Alternate 
Input Unit until it finds a Monitor control card that 
indicates: the beginning of the next job (job card), 
the end of the current batch ( Monitor end card ) , or a 
card directed to the Tele-Processing system. Thus, if 
the program is not being tested, execution of remaining 
programs within this job will not be performed. As an 
example, the Core Image file will not be printed, even 
though a storage print was requested by a Monitor 
control card requesting execution of the Utility pro- 
grams. 

If the dependent program is being tested, the Transi- 
tional Monitor is brought into storage to read the 
Standard or Alternate Input Unit for the next Monitor 
control card. If, for example, a storage print is to be 
taken for the program, a Monitor control card that 
requests execution of the Utility programs would be 
placed at this point in the deck. 

Note: Because core storage is written on the Core 
Image file only for an unusual end of program, and 



because the Core Image file serves as input to the 
Storage Print program of the Utility programs, a de- 
pendent program being tested should end with a 
branch to /uep/, rather than /eop/. This ensures that 
a Storage Print can always be obtained for a program 
being tested, whether it comes to a successful con- 
clusion or not. 

Special End of Program 

The special end of program is the same as unusual end 
of program, except that the Go and Job file contents 
are indicated as invalid and the contents of storage 
are not written on the Core Image file. Because the 
Go and Job file contents are indicated as invalid, the 
Linkage Loader and any program to be loaded from 
the Job file will not be executed if requested, whether 
the test mode is on or off. ( See the "Use of Transi- 
tional Monitor" section for a description of the mode 
card. ) 

To obtain a special end of program, the dependent 
program must have the following coding sequence to 
set the A bit of the /cgo/ field on. This sequence must 
be in the coding before the program branches to /eop/. 

bxpa /mcr/ 

DCW /CGO/ 

dcw ( address of an a bit ) 

dcw (address of dependent program routine 

to be given control if field cannot be 

modified ) 

(Next sequential instruction in the dependent 
program. Usually this instruction is b /eop/. ) 
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Information for Dependent Programs 



The following rules are programming requirements 
that must be met by all dependent programs. 

Use of fhe Resident IOCS 

All programs within the Operating System - those sup- 
plied by ibm and those that are user-written — use the 
Resident iocs. The Autocoder, cobol, and Fortran 
processors automatically generate the necessary link- 
ages to the Resident iocs, in accordance with the 
input/output statements of each source language. ( The 
Autocoder language statements for input/output oper- 
ations are contained in the Basic Input/Output Con- 
trol System publication. ) 

No Halts 

Dependent programs must not use programmed halts. 
At end of program, the programs must branch to the 
Resident Monitor's End-of-Program routine. 

Index Registers 

The System Monitor sets a word mark in the high- 
order position of each index register. Group marks 
must not be placed in that position. Dependent pro- 
grams must not clear or set word marks in the index 
registers. 

Each time the Transitional Monitor is brought into 
storage by the Resident Monitor to process Monitor 
control cards, it clears all index registers, but leaves the 
word mark in the high-order position of each register. 

Various elements of the System Monitor require in- 
dex registers 14 and 15. Therefore, X14 and X15 must 
not be used by any interruptable instruction sequence 
in a dependent program. If used by a non-interrupt- 
able sequence, X14 and X15 must not be left negative. 

Index register 13 is used for subroutine linkage by 
all programs within the Operating System. (For ex- 
ample, the first instruction in the Resident Monitor's 
Print routine is Store B-Address Register into X13. 
The Print routine then uses the contents of index reg- 
ister 13 for reference to the control information in 
the linkage sequence and for returning to the depend- 
ent program at the instruction following the linkage 
sequence. ) 

Index register 13 should be used for linkage to all 
subroutines introduced into the Operating System by 
the installation. Because of the convention of using 
index register 13 for subroutine linkage, ibm subrou- 
tines do not save and restore the contents of this reg- 



ister. Subroutines introduced by the installation also 
do not need to save and restore its contents. However, 
if a dependent program uses index register 13 for pur- 
poses other than subroutine linkage, it should save the 
contents before issuing a linkage sequence to a sub- 
routine and should restore the contents of the register 
after control is returned from the subroutine. 

If index registers 13, 14, and 15 are used by installa- 
tion programs, they must never be left negative. 

Word Separator Characters 

A word mark should never be set over a word sepa- 
rator character. (A word mark over a word separator 
character would be placed on the Core Image file as 
three word separator characters, but would be read 
from the file into core storage as a word separator 
character with a word mark over the following char- 
acter. ) 

Priority Alert Mode 

Dependent programs should not exit from Priority 
Alert mode, except as specified in the section, "Use of 
Resident Monitor Functions," when the dependent pro- 
gram is addressing the Resident Monitor (such as a 
branch to the Print routine ) . 

Unit-Record Interrupts 

A dependent program cannot be initiated by means of 
the Priority Select On-Off Switch on the console. 

/SIZ/ Field 

A dependent program should have a character in the 
highest core-storage position it will use. This character 
enables the Load routine to properly set the /siz/ field 
of the Communication Region. 

Reading from the Standard Input Unit 

Dependent programs must use the Read routine of the 
Resident Monitor to perform any read operations for 
the Standard ( or Alternate ) Input Unit. 

Divide Overflow and Arithmetic Overflow Indicators 

Each time the Transitional Monitor is brought into 
storage by the Resident Monitor to process Monitor 
control cards, it turns off the divide overflow and arith- 
metic overflow indicators. 
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Two Highest Positions of Core Storage 

The Operating System places group marks with word 
marks in the two highest positions of core storage. 
These group marks with word marks must not be de- 
stroyed by dependent programs. 

System Regeneration 

If the installation regenerates the Operating System 
and if the Resident Monitor in the new System Oper- 
ating File was changed from that in the previous Sys- 
tem Operating File, the Job files produced by the 
previous Operating System cannot be used with the 
new system. 
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Use of Transitional Monitor 



Monitor control cards in the Standard (or Alternate) 
Input Unit direct operation of the System Monitor, 
These cards are read and analyzed by the Transitional 
Monitor. The Monitor control cards are listed in 
Figure 7. 

At System Generation, the installation can specify 
that the System Monitor write each Monitor control 
card on the console printer and/or the Standard Print 
Unit. The installation can also elect at System Gener- 
ation to record all job cards on the Standard Punch 
Unit to help separate punched output. 

Figure 7 shows the format for Monitor control cards. 
The standard Autocoder rules apply to the operands 
of Monitor control cards : 

1. Operands must be separated by a comma. 

2. Operands cannot contain blanks. 

8. An intentionally omitted operand must be indi- 
cated by placing its trailing comma adjacent to the 
preceding comma, except where the omitted operand 
is the last one. 

JOB Card 

The job card indicates the beginning of a job. The 
operand is the name assigned to the job by the pro- 
grammer. 

Upon reading a job card, the Resident Monitor 
closes out the previous job as follows : 

1. It completes any remaining iocs requests. 

2. It clears Communication Region fields: size of 
dependent program field ( /siz/ ), interprogram infor- 
mation field ( /ipi/ ), phase number field ( /phn/ ), 
program name field ( /pnm/ ), and other fields used 
internally. 

3. It turns off the indicators in the /cgo/ field set 
for the operands of the mode card ( described below ) . 

4. For tape Standard Print and Punch Units, it 
closes, rewinds, and unloads the tapes, if requested, to 
permit off-line processing after the previous job is 
completed. (These indicators are set by $B2 and $B3 
console inquiries, which are described in the section, 
"Messages and Inquiries.") 

5. It cancels all Reserve file assignments and all 
assignments of alternate physical units. (See the "As- 
signment of Input/Output Units" section. ) 

The Resident Monitor spaces the Standard Print 
Unit to the next page and prints on the Standard Print 
Unit and the console printer one line., which gives : 

1. An "S" or "A" to indicate whether the job card 



was read from the Standard or the Alternate Input 
Unit. 

2. A two-character sequence number that indicates 
the number of job cards that have been read from that 
unit since the beginning of the batch. 

3. The contents of the job card. 

The job card contents and information will be writ- 
ten on the Standard Print Unit and the console printer 
whether or not other Monitor control cards are also 
printed and/or typed. An additional feature, which 
can be specified at System Generation, is the punching 
of job cards on the Standard Punch Unit. 

The System Monitor does not use the operand(s) of 
job cards. However, an installation- written module to 
use the operand(s) can replace the Transitional Mon- 
itor's ibaccount module. 

The ibaccount module, as supplied in the Transi- 
tional Monitor, is a dummy module. After the job 
card is printed and all other job card functions are 
completed, the Transitional Monitor branches to this 
module, which, as supplied, will immediately return 
control to the Transitional Monitor. The installation 
can put into this module accounting routines or any 
other types of routines desired. To replace the dummy 
module with an installation module, see information 
concerning generation of the Transitional Monitor in 
the System Generation publication. 

MODE Card 

This card describes the type of operation wanted in a 
job. The operands for the card are: 

1. GO 

2. TEST 

3. SG 

The go operand may appear on a card with test 
and/or sg operands. The go operand sets the B bit of 
the /cgo/ field on. The B bit is turned off by the next 
job card or the next mode card without a go operand. 

The go operand is used to specify compile-and-go 
operation. If it is specified, the output from following 
compilations will be written on the Go file for subse- 
quent execution within the job. 

If the Go file being used was created any time be- 
fore the last Linkage Loader run, the go mode must 
not be in effect. If the go mode is in effect when a 
previously created Go file is used, the Linkage Loader 
will tape-mark the Go file at the point where the tape 
is when the Linkage Loader execution begins. 
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Location in 
Control Card Deck 



Before first JOB 
card during 



First card in a job 



Before EXEQ card 
for program that 
will use symbolic 



Before EXEQ card 



appln 



Card 
15 16 Type 20 21 Operand(s) 72 



MON$$ 
MON$$ 



MON$$ 
MON$$ 
MON$$ 
MON$$ 
MON$$ 



After JOB card 



A5GN 
ASGN 



MODE 
MODE 
MODE 
MODE 
MODE 



yyddd 

yy=l_ast two num- 
bers in year 
ddd=Three~digit 
number for day of 
the year 



ANY NAME AND 
INFORMATION 



ABC,XX,YY,ZZ 

ABC=Symbolic 
name for input/ 
output file 

XX,YY,ZZ=As- 
signment symbols 
for any number 
of physical units 



Sets Communication Region 
field /DAT/. 



Closes out previous job and be- 
gins new job. 



ABC,XYZ 
UB,SOF 



GO, TEST 

GO,SG 

GO 

TEST 

SG 



MON$$ 



Anywhe 



At end of cards in 
Alternate Input 
Unit and Standard 
Input Unit 



NAME1, MJB.XXX 



Assigns the symbolic unit in the 
first operand to the physical units 
represented by the" assignment 
symbols in the second and follow- 
ing operands. The second operand 
is the base unit and the additional 
operands are alternate units. 



Must be given in daily informatior 
cards during initialization of the 
System Monitor. 



Clears /SIZ/, /IP I/, /PHN/, 
/PNM/. Turns off /CGO/ indi- 
cators for MODE card operands. 



See the section, "Assignment of 
Input/Output Units," for full de- 



Assigns the symbolic unit in the 
first operand to the physical uni 
for the symbolic unit in the sec- 
ond operand. 



Cancels the assignment previously 
made for the symbolic unit in the 
operand. 



GO operand specifies that lan- 
guage processors write on Go 
file for compile-and-go opera- 



TEST operand specifies that rest 
of job is to be executed if pro- 
gram comes to an unusual end. 

SG operand specifies that System 
Generation functions are to be 
performed. (See the System 
Generation publication.) 



Limited to Work files and Reserve 
files, and to the combination: 
System Library file and System 
Operating File. 



MODE card without GO turns GO 
indicator off. 

NOTE: If a previously created Go 
file is being used, do not use MODE 
GO. 

TEST indicator, once turned on, re- 
mains on until next job. 

SG indicator, once turned on, re- 
mains on until System Monitor is 
initialized 



Initiates search for program in 
first operand on System Operating 
File (SOF) or Job file (MJB) 
specified in second operand, then 
causes it to be loaded and exe- 
cuted. 



MON$$ 



MON$$ 



LINKLOAD,SOF,XXX,YYY 



NAME1 for installation programs i 
card of program 

NAME1 for IBM-provided program 
LINKLOAD (Linkage Loader) 
AUTOCODER 
COBOL 
FORTRAN 
SORTDEFINE 
UTILITIES 

502} <■**•*• 

TPADLIBGEN 
TPATLIBGEN 
TPRDLIBGEN 
TPRTLIBGEN 
DSKLIBLDR 
XXX=Symbolic unit where 
input data, source state- 
ments, or the control card 
are located. 
YYY=Name of the 
System Library file 
for this run of the 
Linkage Loader 



defined by first PHASE 



(language processors) 

(Sort Definition program) 
(Utility programs) 

Generation programs) 

(Tele-Processing system programs) 
(Disk Library Loader program) 



3 (in column 1 of 
EXEQ LINKLOAD 
card) 

= Linkage Loader 
memory map not 
printed 



ANY INFORMATION Information in columns 21 through 
TO BE TYPED AND 72 is typed on console printerand 

PRINTED printed on Standard Print Unit. 



Information is typed and printed, 
whether other Monitor control 
cards are similarly recorded or not 



In Alternate Input Unit, causes 
Resident Monitor to resume reading 
from Standard Input Unit, after 
giving operator opportunity to 
close Standard Print Unit, Stand- 
ard Punch Unit, and Core Image 
file. 

In Standard Input Unit, signifies 
end of current series of jobs and 
causes Resident Monitor to enter 
a waiting loop for further In- 
structions from operator. 



If Standard and Alternate Input 
Units are on tape, END card 
causes tape to be rewound and 
unloaded. 



Figure 7. Monitor Control Cards 
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The test operand specifies that following programs 
are being tested. At unusual end of program, the Resi- 
dent Monitor's End-of-Program routine preserves the 
contents of storage on the Core Image file, if this file 
was specified at System Generation. Then, if test mode 
was specified, the Transitional Monitor, when brought 
into storage, reads the Standard or Alternate Input 
Unit for any Monitor control cards. Thus, a card re- 
questing execution of the Utility programs to print the 
Core Image file can be read. If test mode had not 
been specified, the Resident Monitor would cancel any 
remaining portion of the current job. 

If a Utility programs storage print is wanted when 
a program under test successfully reaches end of pro- 
gram, the program must branch to /uep/. 

The test indicator, when turned on by a mode card, 
stays on until the next job or until System Monitor 
initiali2:ation. 

The sg operand turns the System Generation indica- 
tor on. This operand specifies that a System Generator 
file or System Operating File is being generated, or 
that System Generation maintenance procedures are 
being performed. (See the System Generation 
publication. ) 

EXEQ Card 

The exeq card initiates a search for the named pro- 
gram and causes it to be loaded and executed. Before 
the program is loaded, storage from the locations speci- 
fied in the /org/ field to the top of core minus two 
(/ams/) will be cleared. 

The program to be executed is named in the first 
operand. This program may be an installation pro- 
gram, the Linkage Loader, or the other IBM-provided 
programs. The name to be used for an installation pro- 
gram is defined by the first phase card of the program. 

The second operand specifies the file containing the 
program. This operand can be either sof for the Sys- 
tem Operating File or mjb for the Job file. If the second 
operand is omitted, the program is assumed to be on 
the osf. ( Omission must be indicated by a comma, if 
additional operands are used. ) The Resident Monitor's 
Load routine loads the named program from the file 
specified. 

The third operand, which is optional, changes the 
Resident Monitor's Read routine to read from a substi-; 
tute unit instead of the Standard or Alternate Input! 
Unit. After the program is executed, the Read routine 
automatically resumes reading from the Standard In- 
put Unit. This operand cannot be used if the exeq card 
is in the Alternate Input Unit, because the Read rou- 
tine treats the specified unit as a temporary Alternate 
Input Unit. This operand can be used only if the fa- 
cility for reading an Alternate Input Unit was incorpo- 



rated into the Resident Monitor at System Generation. 

This operand must be the symbolic name for a Work 
file, Reserve file, the Standard Input Unit, or the Alter- 
nate Input Unit. 

For an installation program, the third operand can 
specify the location of input data. ( No Monitor control 
cards should appear in this input data. ) 

For the language processors, the third operand indi- 
cates that the source statements do not immediately 
follow the exeq card. This operand specifies the unit 
containing the source statements. 

For the Linkage Loader, the third operand indicates 
the location of the Linkage Loader control cards. 

The exeq linkload card can have a fourth operand 
to specify the System Library file for this Linkage 
Loader run. In a tape-oriented system, the Linkage 
Loader uses two factors to determine the Library to be 
used: 

1. The fourth operand of the exeq card. If blank, the 
Linkage Loader assumes that the Library is the ibm 
Library (named ibmlibr) on the System Operating 
File. 

2. The asgn card. If absent, the Linkage Loader as- 
sumes that the Library named is on the System Oper- 
ating File. 

In a disk-oriented system, the Library name must be 
specified in the fourth operand of the exeq card and an 
asgn card for the Library must be present. 

Installation programs can specify fourth and suc- 
ceeding operands for use of the program named in the 
exeq card. 

When the exeq card contains more than three oper- 
ands, the address of the high-order character of the 
fourth operand is placed in card columns 6 through 10 
in the card input area, overlaying mon$$. No word 
mark is set in column 6. The /crd/ field contains the 
high-order address of the card input area until the next 
read operation performed by the Read routine. 

An exeq linkload card can have an S in column 1 to 
specify that the memory map should not be printed. 
However, the S in column 1 will not suppress the print- 
ing of diagnostic messages. (See the "Messages and In- 
quiries" section. ) 

COMT Card 

The comt (Comments) card is used to record infor- 
mation on the console printer and the Standard Print 
Unit All information in columns 21 through 72 of the 
comt card is typed and printed, whether other Moni- 
tor control cards are similarly recorded. The comt card 
is convenient to: 

1. Give additional instructions to the operator. 

2. Identify a program's output in greater detail than 
the job card permits. 
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ASGN Card 

The asgn card is used to assign input/output units. 
The functions of the asgn card are described in detail 
in the section, "Assignment of Input/Output Units." 

END Card 

The end card must be the last card in the Standard In- 
put Unit and the Alternate Input Unit. 

When this card is read at the Standard or Alternate 
Input Unit, the Resident Monitor does the following: 

1. Closes the unit with a rewind and unload, if the 
unit is tape. 

2. Types two messages: end siu (or end aiu) and 
20501 enter b messages. All class B console inquiries 
will be accepted except $B1, which will be ignored if 
the end card was on the Standard Input Unit. ( For an 
end card on the Alternate Input Unit, see item 4.) 
Thus, the operator can close the Standard Print Unit, 
the Standard Punch Unit, and/or the Core Image file. 
During this time, the System Monitor is in a waiting 
loop and Tele-Processing system interrupts may occur. 
(See the "Messages and Inquiries" section for details 
on console inquiries.) 

3. Remains in the waiting loop until the $BX inquiry 
is entered. Then, the Transitional Monitor resumes 
reading from the Standard Input Unit, which must be 
on the same physical unit used in the previous batch. 
If the end card was on the Standard Input Unit, the 



Transitional Monitor will ignore all cards until it 
reaches the first job card. Then it will begin processing. 
If the end card was on the Alternate Input Unit, the 
Transitional Monitor resumes processing with the next 
Monitor control card on the Standard Input Unit. 

4. If the end card was on the Alternate Input Unit, 
a $B1 inquiry (before the $BX inquiry) will make the 
Transitional Monitor resume reading from the Alter- 
nate Input Unit. 

Two counters are used to determine the number of 
job cards read since the beginning of a batch. One 
counter is associated with job cards read from the 
Standard Input Unit, the other with job cards read 
from the Alternate Input Unit. Each time an end card 
is read from one of the input units, the counter associ- 
ated with that unit is set to zero. 

DATE Card 

The date card contains the date in its operand. The 
first two positions contain the last two numbers in the 
year, and the next three positions contain the three- 
digit number for the day of the year. 

This card is required in the daily information, which 
is before the first job card, during initialization of the 
Resident Monitor. ( See the Operators Guide publica- 
tion for details on initialization,) 

The operand is placed in the /dat/ field of the Com- 
munication Region. 
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Assignment of Input/Output Units 



Input/output units are referenced as : 

1. physical units. Physical unit designates all of, or 
sections of, a physical device. Each physical unit is as- 
signed a two-character assignment symbol at System 
Generation. The assignment symbols are selected by 
the installation. 

2. symbolic units. Symbolic unit designates a file to 
be read from or written on a physical unit. Symbolic 
units are referred to by the symbolic names given in 
this section. 

The symbolic unit names are used in the symunit 
entry of the iocs Define the File statement in programs 
(see the Basic Input/Output Control System publica- 
tion) and in the first operand of the Monitor asgn card. 
The symbolic unit files are assigned to one or more 
physical units by the asgn card and iblookm linkage 
sequence. The assignments are made by assignment 
routines in the Resident and Transitional Monitors. 

To enable an installation to make the most efficient 
use of input/output units for a series of jobs, program 
references to input/output units are made symboli- 
cally. Also, the programmer is freed from concern as to 
which specific input/output units will be available 
when his program is executed. 

A physical unit is one of the following: 

1. A reader, punch, printer, or other unit-record 
device. 

2. A tape unit. 

3. A set of consecutive tracks in a 1301 Disk Storage 
module. 

Note: The 1402 Card Read Punch must be defined 
for each function. (The read function is specified as 
one physical unit, the punch function as another. ) 

The assignment symbols specified for physical units 
during System Generation are placed into a table in 
the Resident Monitor. During operation of the system, 
this table represents the input/output units that are 
available for use by dependent programs and by the 
System: Monitor. 

This table can be changed — in terms of additions 
and deletions — only by another System Generation. 
The operator, however, can indicate through $B5 and 
$B6 inquiries that a physical unit is not currently avail- 
able for use, or that it is again available. (See the 
"Messages and Inquiries" section for details on console 
inquiries.) 

Note: Definition of Tele-Processing devices is also: 
performed during System Generation, but in a differ- 



ent manner. They are defined by specifying the related 
elements of the Tele-Processing Supervisor. (See the 
Tele-Processing Supervisor publication.) The defini- 
tions of Tele-Processing devices are not placed in the 
Resident Monitor's table. However, physical units used 
by programs operating within the Tele-Processing sys- 
tem (other than Tele-Processing devices) are given 
assignment symbols in the same manner as physical 
units for other programs, and their assignment symbols 
are also placed in the Resident Monitor's table. 

Physical Units 

The following example illustrates one possible set of 
assignment symbols to represent physical units. Since 
any scheme of two-character symbols can be incorpo- 
rated into the System Monitor, each installation can 
designate the set of assignment symbols that best suits 
its needs. 

Channel 1 Tape Units: A0 ( A-zero ) through A9 
Channel 2 Tape Units: BO through B9 
Unit-Record Equipment: 

1402 Card Read Punch (read function) : CI 

1402 Card Read Punch (punch function) : C2 

1403 Printer: C3 

Tracks of Disk Storage (Channel 1, Module 0) : 

0000-0079: Dl 

0120-0159: D2 

7000-7999: D3 

(Note that although the tracks that constitute each 

physical unit must be consecutive, separate physical 

units need not be consecutive or contiguous.) 
Tracks of Disk Storage ( Channel 1, Module ) : 

4000-8999: El 

9315-9386: E2 

(Note that track assignments need not begin and 

end at cylinders.) 
Tracks of Disk Storage (Channel 2, Module 0) : 

0000-9999: Fl 
Note: Physical unit track definitions may overlap each 
other. 

Symbolic Units 

The symbolic names to be used for symbolic units are 
defined during System Generation, when they are 
placed in the Resident Monitor table. During system 
operation, this table is used in conjunction with the 
table of physical units to assign input/output units for 
program use. 
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Symbolic units are divided into four groups, in ac- 
cordance with the type of program that uses the sym- 
bolic unit: 

1. System files are used by the System Monitor. 

2. Work files are used by IBM-provided components 
of the Operating System. 

3. Reserve files are used by installation programs. 

4. Tele-Processing system files are used by installa- 
tion programs that operate under control of the Tele- 
Processing Supervisor. 

Note: Work files can also be used by installation 
programs, but care must be exercised to ensure that 
conflicts do not arise between assignments for ibm- 
provided programs and assignments for installation 
programs. 

The symbolic names for the symbolic units are listed 
below. For each System file, the symbolic name is pre- 
determined; for the other three groups of symbolic 
units, the symbolic names are assigned from the specif- 
ic sets by the Operating System at System Generation. 
System files: 

sof — System Operating File 

siu — Standard Input Unit 

spr — Standard Print Unit 

spu — Standard Punch Unit 

aiu —Alternate Input Unit 

lib — System Library file 

mjb — Job file 

mgo — Go file 

mdm — Core Image file 

mlt — tp Library file ( for Tele-Processing sys- 
tem) 

mdt — Temporary Storage file ( for Tele-Process- 
ing system) 
Work files: 

mwO ( Mw-zero ) through mw9 

mwa through mwz 
Reserve files: 

mrO through mr9 

mm through MRZ 
Tele-Processing system files: 

mtO through mt9 

mta through MTZ 

Assignment Times for Symbolic Units 

The symbolic units are divided into five categories 
with respect to the times that they can (or must) be 
assigned to physical units : 

1. Symbolic units that are assigned during System 
Generation, initialization, or reinitialization: 
sof ( System Operating File ) 
siu ( Standard Input Unit ) 
Note: The device type for the System Operating 



File cannot be changed at initialization or reinitial- 
ization. 

2. Symbolic units that are assigned during initializa- 
tion or reinitialization of the System Monitor and 
cannot be reassigned, except by initialization or reini- 
tialization procedures : 

spr ( Standard Print Unit ) 

spu ( Standard Punch Unit ) 

mdm ( Core Image file ) 
Note: Assignment of these units is part of the daily 
information supplied to the System Monitor during ini- 
tialization and reinitialization procedures. These units 
must be assigned if facilities for them were incorpo- 
rated into the Resident Monitor at System Generation. 

3. Symbolic units that can be assigned during ini- 
tialization or reinitialization procedures and can also 
be assigned or reassigned between each run within a 
job: 

lib ( System Library file ) 

aiu ( Alternate Input Unit ) 

mwx ( All Work files ) 
Note: The Alternate Input Unit cannot be assigned 
by a control card that is read from the Alternate Input 
Unit. The System Library file should not be assigned if 
it is on the System Operating File. Three Work files 
must be assigned for the Autocoder and cobol lan- 
guage processors; the physical units, if tape drives, for 
two of these files should be on one channel and the 
physical unit for the third file should be on the other 
channel, for maximum processor efficiency. The physi- 
cal units, if tape, for the two Work files that must be 
assigned for the Fortran processor should be on differ- 
ent channels. (See the Operators Guide publication 
for full details.) 

4. Symbolic units that are assigned between each 
job: 

mjb ( Job file ) 

mgo ( Go file ) 

mrx ( All Reserve files ) 
Note: The System Monitor cancels the assignment 
of these units at each job card. These files can be 
assigned (or reassigned) between each run within a 
job. However, care should be taken in reassigning the 
Job and Go files to ensure that the Linkage Loader and 
language processors have the proper input/output files. 

5. Symbolic units that can be assigned at System 
Generation or at other times when the Tele-Processing 
system is not open: 

mlt ( tp Library file ) 
mdt ( Temporary Storage file ) 
mtx ( All Tele-Processing system files ) 
Note: The assignment of these units is canceled 
when the total System Monitor is initialized or reini- 
tialized. Between initializations (or reinitializations) 
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of the total System Monitor, these assignments are 
maintained, regardless of the number of times the 
Tele-Processing system is opened and closed. The as- 
signments can, however, be changed by asgn cards 
each time the Tele-Processing system is closed. 

Program References to Symbolic Units 

After the installation has established the set of sym- 
bolic names for the symbolic units, these names are 
used in installation programs to designate the symbolic 
units for a program's files. For example, in Autocoder, 
the symbolic name is used in the symunit entry of the 
Define the File statement, cobol and Fortran similarly 
provide means by which the programmer identifies 
symbolic units for a program. 

The Linkage Loader converts the symbolic names 
for the symbolic units into machine addresses that en- 
able the Resident and Transitional Monitors to assign 
input/output units in accordance with the asgn cards. 

ASGN Card 

The asgn card, which is a Monitor control card, directs 
the System Monitor to assign one or more physical 
units to a particular symbolic unit. 

As shown in Figure 8, the first operand of an asgn 
card is the symbolic name for the symbolic unit. The 
second operand is the assignment symbol for the first 
physical unit ( the base unit ) to be assigned to that 
symbolic unit. Additional operands can be used to 
specify alternate units. 

In Figure 8, a1 is the base unit; a2 and a3 are the 
alternate units. When end of unit is reached for a1, the 
next input/output operation for mrI will be performed 
with the physical unit represented by a2. (For tape, 
end of unit is determined by reaching end of reel; for 
disk, end of unit is determined by reaching the end of 
the set of tracks that constitute one physical unit. The 
use of alternate units does not apply to unit-record 
equipment. ) 

At the end of unit for a2, the next input/output op- 
eration for mrI will be performed with the physical 
unit represented by a3. The end of unit for a3 is con- 
sidered end of file for the symbolic unit mrI, if mrI 
represents a disk file. However, if mrI represents a 
tape file, continuous cycling of the physical units is 
performed. Thus, a1 would be the fourth physical unit 
used. In such a case, end of file is determined by reel 
counts, trailer labels, or end-of-reel conditions (for un- 
labeled tapes.) . 



A physical unit can be assigned to more than one 
symbolic unit at the same time. For example, a job in- 
volving a compile-and-go operation could use a tape 
unit as a Work file for the language processor and then 
use the same unit as a Reserve file for the program that 
was just compiled. The asgn cards for the two symbolic 
units can both be placed immediately behind the job 
card for this job. The System Monitor makes the as- 
signments as the asgn cards are read, but since assign- 
ments are not used until a program initiates an input/ 
output operation through the iocs, no conflict occurs 
because of the dual assignment. Figure 9 illustrates the 
use of two asgn cards to assign the same physical unit 
to different symbolic units. 
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Figure 9. Assignment of Two Symbolic Units to the Same 
Physical Unit 



Note that all symbolic units that share a base unit 
also share any alternate units specified for that base 
unit. The physical units are shared in the same order. 
A base unit assigned to one symbolic unit cannot be 
assigned to another symbolic unit as an alternate unit. 
(For example, these two assignments cannot exist si- 
multaneously: mr1,a1,a2 and mr2,a2. ) However, if an 
alternate unit must be assigned as the base unit of 
another symbolic unit later in the job ( or vice versa ) , 
the initial assignment must be canceled. 



CANCELLATION OF ASSIGNMENT 

Symbolic unit assignments are canceled by an asgn 
card containing only the first operand. For example, 
the asgn card in Figure 10 cancels the assignment for 
the Reserve file mrI. This cancellation permits the 
physical units previously assigned to mrI to be used 
for another file. 
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Figure 10. Cancellation of Assignment 
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The asgn card in Figure 10 and the asgn card used 
to assign mrI's physical units to the next file should 
both be placed immediately before the exeq card for 
the program that uses the next file. (The card that can- 
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eels the assignment to mrI must precede the card that 
makes the new assignment of the physical units. ) 

PLACEMENT OF THE ASGN CARD 

The asgn cards are submitted to the System Monitor 
through the Standard ( or Alternate ) Input Unit. The 
position of an asgn card in the control card deck is de- 
termined by the category of symbolic unit named in 
the asgn card. 

asgn cards for symbolic units that are assigned dur- 
ing initialization or reinitialization are in the daily in- 
formation in the Standard Input Unit. 

asgn cards for symbolic units that are assigned only 
for the duration of a job must follow the related job 
card and precede the exeq card for the program that 
uses the files. 

asgn cards for symbolic units that are used by the 
Tele-Processing system must precede the control card 
or the console inquiry that opens the Tele-Processing 
system. 

Use of the ASGN Card for System Files 

The physical units assigned to certain System files can- 
not be assigned to any other symbolic units during the 
time they are assigned to the System files. These Sys- 
tem files are: 

sof ( System Operating file ) 

siu ( Standard Input Unit ) 

spr ( Standard Print Unit ) 

spu ( Standard Punch Unit ) 

lib ( System Library file ) 

mdm ( Core Image file) 
In addition, physical units assigned to symbolic units 
used by the Tele-Processing system cannot be assigned 
to any other symbolic units when the Tele-Processing 
system is ready to receive input from Tele-Processing 
devices. 

The physical units assigned to the System Operating 
File and the Standard Input Unit can be reassigned to 
other symbolic units only through System Generation, 
initialization, or reinitialization. The physical units as- 
signed to the Standard Print Unit, the Standard Punch 
Unit, and the Core Image file can be reassigned to 
other symbolic units only through initialization or re- 
initialization. The physical unit assigned to the System 
Library file ( if this file is not part of the System Oper- 
ating File) can be reassigned to other symbolic units 
either through initialization and reinitialization or 
through cancellation of the Library's assignment by an 
asgn card containing lib as the only operand or con- 
taining the operands sof,lib. 

For compile-and-go operations, the Go file must not 
be assigned to a physical unit used for the language 
processor's Work files. 



Linkage Sequence for Assignment of Symbolic Units 

Through the iblookm linkage sequence, a dependent 
program during its execution can set the symbolic unit 
selection for any Reserve file, Work file, or Tele- 
Processing system file. Using this sequence, the de- 
pendent program is written to operate with any sym- 
bolic unit. It is stored in absolute format in the System 
Operating File. If this sequence were not used, the 
program would have to be processed by the Linkage 
Loader each time to resolve the one symbolic unit 
entry that would change with each execution. 
The linkage sequence is : 
dcws iblookm 



dcw 

DCW 
B 



JSYMf 



FILE 



(address of dependent program instruc- 
tion to which control is to be given if 
symbolic unit requested is not a Re- 
serve, Work or Tele-Processing sys- 
tem file or does not exist) 
(Next sequential instruction in dependent pro- 
gram) 
Where sym = The symbolic name of the symbolic 
unit to be used by the dependent 
program. 
file = The label used in the Define the File 
Header Line for the corresponding 
file. 
Note: The iblookm module must be on the cur- 
rently assigned System Library file. 

To use this sequence, a control card can be read dur- 
ing program execution to supply the information for 
the sym operand. Such a program could be a Utility 
program written to print any tape file. 

The following Autocoder macro-instruction can be 
vised to generate the above linkage sequence: 

anylabel monop resolve,sym,file,nomodaddr 
resolve operand: must appear as shown. 

sym operand: is the symbolic name for 

the symbolic unit. 
file operand: is the label for the Define 

the File Header Line for 
the corresponding file. 
nomodaddr operand: optional. This is the ad- 
dress of the dependent 
program instruction to 
which control is to be 
given if the symbolic 
unit requested is not ad- 
missible. If omitted, 
control will be returned 
to the next sequential in- 
struction following the 
macro-instruction. 
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Messages and Inquiries 



During operation, the System Monitor types informa- 
tion and diagnostic messages on the console printer 
and/or prints them on the Standard Print Unit. If an 
installation does not specify a Standard Print Unit at 
System Generation, it will not receive certain informa- 
tion and messages that are printed only on the Stand- 
ard Print Unit. 

The System Monitor can also receive inquiries 
through, the console printer. 



Memory Map 

The Linkage Loader will write information on the 
Standard Print Unit to provide a memory map of the 
program being relocated. This memory map informa- 
tion will be interspersed with Linkage Loader diagnos- 
tic messages. 

The column headings printed at the top of the mem- 
ory map are: 

MESSAGE CARD NAME VALUE SYMBOL VALUE SYMBOL 

VALUE SYMBOL VALUE SYMBOL VALUE SYMBOL VALUE 

All Linkage Loader error messages will begin in the 
message column. 

The card column contains the name of the following 
five key Linkage Loader control cards in the order in 
which they are processed. All information about each 
card will be printed on one line. 

PHASE Card: The word phase will appear in the 
card column. The program name will appear in the 
name column for a phase card with an operand; for a 
blank-operand phase card, the name column will be 
blank. The upward relocation factor for the phase will 
be printed in the leftmost value column. Note that if a 
baseI card is processed after the phase card, but be- 



fore any load cards, the value column of the phase 
card line will not be accurate. 

BASEI Card: The word baseI will appear in the 
card column. The leftmost value column will contain 
the new upward relocation factor. 

BASE2 Card: The word base2 will appear in the 
card column. The leftmost value column will contain 
the new downward relocation factor. 

PRTCT Card: The word prtct will appear in the 
card column. The leftmost value column will contain 
the new protection value for the Linkage Loader 
symbol table. 

TITLE Card: The word title will appear in the 
card column. The subprogram name will appear in the 
name column. The leftmost value column will contain 
the absolute address at which the first character in the 
subprogram will be loaded. To the right of the leftmost 
value column will be printed rel factor xxxxx, where 
xxxxx is the relocation factor actually used in relocat- 
ing the subprogram. 

The linkage symbols used, and their corresponding 
absolute addresses, will be printed in the five sets of 
symbol and value columns in the right half of the 
memory map. 



Monitor Diagnostic Messages 

The following messages are typed on the console 
printer and/or printed on the Standard Print Unit. 
These messages are: 

1. Diagnostic messages for programmers 

2. Messages for operators 

3. Initialization messages 

4. Bootstrap routine messages 

5. Messages during restart 



Diagnostic Messages for Programmers 



MESSAGE 

UEPX 
UEPl 

uep2 

uep321274 
uep938918 
uep9 



explanation 

Unusual end of program. Execution of 
program has been terminated or the 
Transitional Monitor has determined that 
the remainder of the job cannot be suc- 
cessfully executed. 

If x = 1 : Dependent program request- 
ed a phase that could not be found. 

If x = 2: Dependent program request- 
ed a phase to be loaded and executed. 
Phase was loaded, but has no entry point. 



location 

Console 
printer 



ACTION 

None by operator. 
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EXPLANATION 



LOCATION 



00501 SOF 
DIRECTORY NOT 
FOUND 

00502 MJB 
DIRECTORY NOT 
FOUND 



00503 INVALID 
DIRECTORY RECORD 



10520 CGO-LL 



10521 CGO-MJB 



10522 1st op inv 
10522 2nd op inv 

10522 3rd op inv 

10523 no aiu 



10524 aiu 

ACTIVE 



10525 chg ttttt 



If x = 3: Dependent program at- 
tempted input/output with a symbolic 
unit for which no physical unit was as- 
signed. Or, a file table in the dependent 
program contains a symunit field with 
an address that does not correspond to 
any entry in the Resident Monitor's table 
of symbolic units. 

Note: If x = 3, the message contains 
the address of the units position of file 
table field before the symunit field. 

If x = 9: A branch to the /uep/ entry 
point of the End-of-Program routine 
was made from outside the Resident 
Monitor. When a dependent program 
branches to /uep/, the message will con- 
tain the contents of the B-Address Reg- 
ister at the time of the branch. If the 
address is absent, i.e., uep9 message, the 
Transitional Monitor entered the End- 
of-Program routine at the /uep/ point 
and the status of core storage was not 
written on the Core Image file. 

Transitional Monitor is unable to find 
a directory for the System Operating 
File. 

Transitional Monitor is unable to find 
a directory for the disk Job file. The 
directory was inadvertently destroyed, an 
error was made in assignment, or the 
Linkage Loader is not functioning prop- 
erly. 

Transitional Monitor has located what 
should be the directory for the disk Sys- 
tem Operating File, but record read was 
not a valid directory record. 

A language processor has canceled the 
Go file and execution of the Linkage 
Loader is, therefore, being bypassed. 

The contents of the Job file are not 
valid; therefore, the exeq card for a 
program on the Job file is being bypassed. 

An exeq card with an invalid operand 
has just been read and is being bypassed. 

An exeq card with a third operand 
has just been read but cannot be pro- 
cessed because facilities for using an 
Alternate Input Unit were not specified 
at System Generation. 

An exeq card with a third operand 
has just been read from the Alternate 
Input Unit and is, therefore, being by- 
passed. 

The symbolic unit in the third operand 
of the exeq card just read cannot be 
found in the Resident Monitor's assign- 
ment table. Therefore, the Transitional 
Monitor cannot effect a change to that 
unit. The exeq card is bypassed. 

ttttt = The address of the Transi- 
tional Monitor routine that tried to effect 
the change. 



Console printer 
and/or Standard 
Print Unit 

Console printer 
and/or Standard 
Print Unit 



Console printer 
and/or Standard 
Print Unit 



Console printer 
and/or Standard 
Print Unit 

Console printer 
and/or Standard 
Print Unit 

Console printer 
and/or Standard 
Print Unit 

Console printer 
and/or Standard 
Print Unit 



Console printer 
and/or Standard 
Print Unit 



Console printer 
and Standard Print 
Unit 



None by operator. (System Operating 
File must be regenerated.) 

Reinitialization is necessary, if the 
batch is to be continued. The situation 
should first be analyzed to determine the 
exact cause of error. Regeneration of the 
System Operating File may be required. 

None by operator. (System Operating 
File must be regenerated. ) 



None by operator. 
None by operator. 
None by operator. 
None by operator. 

None by operator. 
None by operator. 
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10526 chg 

UNASGN 



10527 CHG INV 



10529 GO DSK 
EXC 



10530 not 

FOUND 



10531 NOT 
FOUND IN 

SOF DIRECTORY 

10532 INCOMPATI- 
BILITY IN BLOCK 
COUNTS 



10535 MJB 
INVALID LOC 



EXPLANATION 

The symbolic unit in the third opejrand 
of the exeq card just read is not cur- 
rently assigned to a physical unit. The 
exeq card is bypassed. (This message 
possibly could occur if parts of the Resi- 
dent Monitor were destroyed, breaking 
the assignment for the Standard and/or 
Alternate Input Unit.) 

The symbolic unit in the third operand 
of the exeq card just read is currently 
assigned to a disk physical unit, which 
is not permissible. The exeq card is by- 
passed. 

During compilation, the disk physical 
unit assigned to the Go file has been 
exceeded. The language processor! has 
canceled the Go file and returned control 
to the System Monitor. 

Tape System Operating File: The pro- 
gram named in the exeq card cannpt be 
found on the System Operating File, if 
sof specified on card, or on the Job file, 
if mjb specified on card. The exeq card 
is bypassed. 

Disk System Operating File: The pro- 
gram named in the exeq card cannot be 
found in the directory specified by the 
card. The exeq card is bypassed. 



LOCATION 



Console printer 
and Standard Print 
Unit 



ACTION 

None by operator. 



Console printer 
and Standard Print 
Unit 



Console 
printer 



Console printer 
and/or Standard 
Print Unit 



The program, named in the exeq card 
is not listed in the tape System Operating 
File directory. The exeq card is bypassed. 



Using block counts to search the Sys- 
tem Operating File, the Transitional Mon- 
itor is unable to locate the desired pro- 
gram. One correction attempt will be 
made and, if not successful, the System 
Operating File will be rewound and 
sequentially searched. 



Console printer 
and/or Standard 
Print Unit 

Console printer 
and/or Standard 
Print Unit 



In searching the Job file, the Simple 
Search of System Tape subroutine has 
read one record from the file; this record 
is not a phase header record. The two 
possible causes are: 

1. The physical unit assigned to the 
Job file does not contain the Job file. 

2. The Job file tape has been moved 
to an incorrect position. 



Console printer 
and/or Standard 
Print Unit 



None by operator. 



None by operator. 



None by operator. (The System Oper- 
ating File or Job file should be analyzed 
to determine the reason for the failure, 
in a tape system. The directory for the 
System Operating File or Job file should 
be analyzed to determine the reason for 
the failure, in a disk system. ) 



None by operator. (The tape System 
Operating File directory should be ana- 
lyzed to determine the reason for the 
failure. ) 

None by operator. 

Note: The frequent appearance of 
this message indicates one or more of the 
following conditions: 

1. Block counts in directory are wrong. 

2. Block counts in phase headers are 
wrong. 

3. Backspace often fails on the tape 
unit. 

Correction of the trouble will improve 
search time for the System Operating 
File. 

None by operator. The System Monitor 
will give control to the End-of-Program 
routine at the /uep/ entry point. 



Messages for Operators 

MESSAGE EXPLANATION 



LOCATION 



20501 ENTER B 

MESSiAGES 



Transitional Monitor is ready to ac- Console 
cept class B messages from operator. printer 



1. Press INQUIRY REQUEST. 

2. Enter message. (Class A messages 
are also acceptable at this time. ) 

3. Press inquiry release. 

Note: This procedure is repeated for 
each message. The last message must be 
$BX to cause normal processing to re- 
sume. 
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EXPLANATION 



LOCATION 



20502 SUB 
FOR SS 



An asgn card has been read for a Console 
physical unit that is currently unavailable, printer 



20503 inv 
AIU end 

SITUATION 



20504 inv 

B INQ 



ASGN OP 

invalid xnn 



INV A MSG 



SWITCH TO NEXT 

SIU w/o 

INITIALIZATION 



10104 REP INQ 



end card or end of file has been en- Console 
countered on the Alternate Input Unit, printer 
but a return to the Standard Input Unit 
cannot be effected. (Possible cause: con- 
tents of Standard Input Unit input area 
have been destroyed. ) Transitional Moni- 
tor has entered a dead-end waiting loop. 

Invalid console inquiry has been made Console 
while Transitional Monitor is ready to printer 
accept class A or B messages. Monitor 
remains in waiting loop. 

asgn card operand is invalid. System Console 
Monitor rejects assignment and enters printer 
End-of-Program routine at /uep/ entry 
point. 

nn = Number of asgn card operand 
that was invalid. 

x = ( blank ) : Either the symbolic 
unit or the physical unit could not be 
found in the Resident Monitor's assign- 
ment table. 

x = 4: Sequence rules for sharing 
physical units were violated. ( For ex- 
ample, if "mw2,a1,a2" is a current as- 
signment, then "mw5,a2,a3" cannot be 
made. ) 

x = 8: Rules for sharing physical units 
were violated. (For example, the physi- 
cal unit used by the Standard Input Unit 
cannot also be assigned to another sym- 
bolic unit.) 

x = T: Attempt was made to assign 
a Tele-Processing system file when the 
Tele-Processing system was open. 

end card or end of file has occurred Console 
on the Alternate Input Unit. printer 

end card or end of file has occurred Console 
on the Standard Input Unit. printer 

An invalid console inquiry was en- Console 
tered when only class A messages can printer 
be accepted. The message has been ig- 
nored and processing resumed. 



The System Monitor has begun read- Console 
ing the new Standard Input Unit batch printer 
in accordance with instructions from the 
console. (This message occurs when a 
new batch has been placed on the Stand- 
ard Input Unit, and the waiting loop 
following the end of the previous Stand- 
ard Input Unit has been broken by the 
$BX inquiry.) 

Console inquiry was made while a Console 
previous inquiry was being processed; printer 
error occurred during a console read; 
or console inquiry was canceled. 



1. Press INQUIRY request. 

2. Enter class C message: $Clss. 

3. Press inquiry release. 

Note: The $B6ss message cannot be 
used at this time to remove the unavail- 
able indication from the unit named in 
the 20502 sub for ss message. 

Reinitialization is necessary if batch 
is to be continued. 



1. Press INQUIRY REQUEST. 

2. Enter valid message. ( If none, enter 
$BX.) 

3. Press inquiry release. 

Correct asgn card. 



None by operator. 

None by operator. 

Repeat the console inquiry, if a valid 
class A message was intended. Otherwise, 
wait until "20501 enter b messages" 
appears on the console printer before 
repeating the console inquiry. 

None by operator. 



Repeat console inquiry. 
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MESSAGE EXPLANATION 

10103 cpt nnx Records have been written on the 

Core Image file., because an unusual: end 
of program occurred or the current pro- 
gram took a checkpoint. 

nn zr Number of such records since 
the last initialization of the system. 

x = C: Checkpoint. 

x = D: Contents of core storage writ- 
ten on Core Image file following an un- 
usual end of program. 



LOCATION 

Console 
printer 



ACTION 

None by operator. 



Initialization Messages 

For details on initialization and reinitialization, see the Operators Guide publication. 



DATE 
NOT ENTERED 



ENTER DATE, 
I/O ASSIGN- 
MENTS, JOB 
NUMBERS 



ENTER JOB 
NUMBERS 



ENTER RST 
NUMBER 



ENTER SOF/SIU 
ASGN SYMB 



EOF SIU/AIU IN 
INIT 



INIT ASGN 
EXCEED TABLE 



(asgn card 
image) invalid 

ASSIGNMENT 



INV INITIAL 
CHAR 



EXPLANATION 



LOCATION 



First job card has been read, but no Console 
date card has been processed. printer 

Initialization routine is ready to accept Console 
initialization information. (This message printer 
is given only during reinitialization with- 
out rewind. ) 

Initialization routine is ready to accept Console 
job numbers for the Standard or Alter- printer 
nate Print Unit. (This message is given 
only during reinitialization with rewind.) 



Initialization routine is ready to accept Console 
the number of the checkpoint that is to printer 
be used for the restart. 

Initialization routine is ready to accept Console 
the assignment symbols for the System printer 
Operating File and the Standard Input 
Unit. (This message is given only when 
a word mark has been entered into lo- 
cation 00000.) 



Initialization routine has encountered Console 
an end-of-file condition on the Standard printer 
or Alternate Input Unit. 

Initialization routine for disk-oriented Console 
system has been given more initial as- printer 
signments than can be stored in the table 
it is building for reinitialization. (Be- 
cause the table will accommodate up to 
150 assignments, this message is not nor- 
mally expected.) 

Initialization routine has read an asgn Console 
card that cannot be processed. ( The asgn printer 
card could be constructed internally from 
an assignment entered through the con- 
sole printer.) 

Character at location 00000 is not a Console 
valid initialization status character. ( That printer 
is, it is not A, B, C, or D. ) 



1. PreSS INQUIRY REQUEST. 

2. Enter five-character date. 

3. Press inquiry release. 

1. Press inquiry request. 

2. Enter five-character date. 

3. Press inquiry release. 

4. Wait for next message, which should 
be "io or jn". 

1. Press inquiry request. 

2. Enter two-character job numbers 
(Standard Print Unit first). If the Alter- 
nate Input Unit is not included in an 
installation or was not assigned when the 
need for reinitialization arose, enter two 
blank characters for the Alternate Input 
Unit job count. (A total of four charac- 
ters must be entered. ) 

3. Press inquiry release. 



1. Press inquiry request. 

2. Enter three-character 
number. 

3. Press inquiry release. 



checkpoint 



1 . Press inquiry request. 

2. Enter assignment symbols for Sys- 
tem Operating File and Standard Input 
Unit. Both must be entered even if only 
one assignment is being changed. System 
Operating File symbol must precede 
Standard Input Unit symbol. 

3. Press inquiry release. 

Start over with the proper input on 
the unit. 



Start over with fewer asgn cards pre- 
ceding the first job card. 



None. (This message is given to supply 
a reference for the message "io or jn re 
enter xxx", which should immediately 
follow. ) 



Start over with 
status character. 



a valid initialization 
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MESSAGE 
IO OR JN 



IO OR JN RE 
ENTER XXX 



MUST ENTER 
SOF/SIU ASGN 
SYMB 



SHARE VIOLA- 
TION, MONITOR 
COMPILATION 



JOB SEARCH OUT 
OF STEP 



EXPLANATION LOCATION 

Initialization routine is ready to accept Console 
input/output assignments or job numbers, printer 
(This message is given only during re- 
initialization without rewind.) 

The first time this message appears dur- 
ing reinitialization, it indicates the date 
has just been processed. Each successive 
time the message appears, it indicates 
that the assignment just entered through 
the console printer has been processed; 
the Initialization routine is ready to ac- 
cept the next assignment or, if all assign- 
ments have been given, the job numbers 
for the Standard and Alternate Input 
Units. 



This message is given to permit the Console 
operator to correct an invalid assignment printer 
or to cancel the assignment by entering 
the job numbers for the Standard and 
Alternate Input Units. 

System Operating File is on a unit Console 
different from the one specified at System printer 
Generation, but operator did not enter a 
word mark at location 00000 to request 
a change of assignment. 



At System Generation, the rules con- Console 
cerning the assignment of System files printer 
were violated. This violation is detected 
during the first initialization of the Sys- 
tem Operating File containing the invalid 
assignments. 

Something has caused the Initializa- Console 
tion routine to search past the job count printer 
entered. (This message is given only 
during reinitialization with rewind.) 



ACTION 

1. Press INQUIRY REQUEST. 

2. Enter a five-character assignment 
(symbolic unit name followed by assign- 
ment symbol) or, if all assignments have 
been entered, enter two-character job 
numbers (Standard Input Unit first). If 
the Alternate Input Unit is not included 
in an installation or was not assigned at 
the time the need for reinitialization 
arose, enter two blank characters for the 
Alternate Input Unit job number. 

3. Press inquiry release. 

Note: An inquiry request and in- 
quiry release must precede and follow 
each five-character assignment entry and 
the four-character job numbers entry. 

1. Press inquiry request. 

2. Enter five-character assignment or 
two two-character job numbers. 

3. Press inquiry release. 



1. Press inquiry request. 

2. Enter current assignments for both 
the System Operating File and Standard 
Input Unit. Enter the two-character as- 
signment symbol for the System Operat- 
ing File first, immediately followed by 
symbol for Standard Input Unit. 

3. Press inquiry release. 

None. (A new System Operating File 
must be generated to correct the invalid 
assignment s).) 



Begin reinitialization again. 



Bootstrap Routine Messages 



BOOTSTRAP 
ERROR 01 



BOOTSTRAP 
ERROR 02 



BOOTSTRAP 
ERROR 03 



BOOTSTRAP 
EBROR 04 



EXPLANATION LOCATION 

Bootstrap routine, in a tape system, Console 
has found a header record, rather than printer 
an execute record, after the Resident 
Monitor record on the System Operating 
File. The Bootstrap routine has entered 
a waiting loop. 

Tape read error, other than wrong- Console 
length record, persists after re-reading printer 
nine times. The Bootstrap routine has 
entered a waiting loop. 

A tape read error occurred while the Console 
Bootstrap routine was trying to read a printer 
header record. The Bootstrap routine has 
entered a waiting loop. 

The first record after the Bootstrap Console 
routine is not a header record. The Boot- printer 
strap routine has entered a waiting loop. 



ACTION 

Begin bootstrap again. 



Begin bootstrap again. 



Begin bootstrap again. 



Begin bootstrap again. 
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BOOTSTRAP 
ERROR 05 



BOOTSTRAP 
ERROR 06 



BOOTSTRAP 
ERROR 07 



00438 



00202 



EXPLANATION LOCATION 

The instruction loaded by the Bootstrap Console 
routine into location 00000 is not valid printer 
because it does not contain a non-over- 
lap character in location 00002. The 
Bootstrap routine has entered a waiting 
loop. 

Disk read error persists after re-reading 
five times. The Bootstrap routine has en- 
tered a waiting loop. 

The Bootstrap routine has found an 
unidentifiable record while loading the 
Resident Monitor. The Bootstrap routine 
has entered a waiting loop. 

The instruction loaded by the Boot- 
strap routine into location 00000 is not 
valid because it does not contain a valid 
non-overlap character for any channel 
in location 00002. The computer has 
halted. 

A tape read error, other than wrong- Console 
length record, occurred while the Boot- printer 
strap 2 routine was being read. The com- 
puter has halted. 



ACTION 

Begin bootstrap again. 



Console 


Begin bootstrap again 


printer 




Console 


Begin bootstrap again 


printer 




Console 




printer 


Begin bootstrap again 



Begin bootstrap again. 



Messages During Restart 



MESSAGE 
10533 SIU U/R 



10534 aiu u/r 



10528 spu-spr 
same unit 



EXPLANATION 



LOCATION 



Because the Standard Input Unit is a Console 
card reader, no attempt will be made by printer 
the Restart program to reposition the 
Standard Input Unit during restart, j 

Because the Alternate Input Unit is a Console 
card reader, no attempt will be made; by printer 
the Restart program to reposition the 
Alternate Input Unit during restart. 

Because the Standard Punch Unit and Console 
Standard Print Unit share the same tape printer 
unit, the Restart program will make! no 
attempt to reposition this unit during 
restart. 



ACTION 

None by operator. 



None by operator. 



None by operator. 



Linkage Loader Diagnostic Messages 

The following is a list of diagnostic messages printed, by the Linkage Loader on the Standard Print Unit. 



SOF LIBRARY NAME UNEQUAL 
TO EXEQ CARD 



/LIB/ HEADER NAME UN- 
EQUAL TO EXEQ CARD 

INPUT CARD INVALID 



***** BAD INPUT CARD 

( f ollowed by contents of card ) 



The name of the relocatable library specified 
in the fourth operand of the exeq linkload 
card cannot be found on the System Operating 
File. 

The physical unit assigned to lib does not 
contain the library named in the fourth operand 
of the exeq linkload card. 

The operand of the input card cannot be 
identified by the Linkage Lojader. 

The card type in column 72 or the card 
name in column 16 is in errbr. (The input card 
can be any card, not just ] the input control 
card. ) 



The Linkage Loader will end execution with 
a special end of program. 



The Linkage Loader will end execution with 
a special end of program. 

The Linkage Loader will end execution with 
a special end of program. 

The Linkage Loader will end execution with 
a special end of program. 
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***** BAD INDICATOR (fol- 
lowed by contents of card) 

***** CORE EXCEEDED (fol- 
lowed by contents of card) 



***** SYMBOL UNDEFINED 

( followed by contents of card ) 

***** TABLE OVERFLOW 



***** SNAP IGNORED (fol- 
lowed by contents of snap 
card) 



***** BAD LOAD ADDR (fol- 
lowed by contents of card ) 

***** JOB FILE NOT CREATED 



***** UNRESOLVED ENTRIES 
NONE 

***** UNRESOLVED ENTRIES 

(list of unresolved linkage 
symbols and calls) 



MEANING 

One of the relocation indicators on the card 
is in error. 

The relocated load address plus the size of 
the common data area is greater than the ma- 
chine's highest addressable location. 

The symbol in the operand (for a control 
card) or used as the load address (for a load 
card ) has not been defined. 

The Linkage Loader symbol table has been 
exceeded. 



This message indicates that the subprogram 
named in the snap card has not been processed. 
The message can also indicate that columns 
56 and 57 of the snap card were blank. 

After relocation, the load address in the 
printed card is in the Resident Monitor area. 

This message indicates that ( 1 ) the Linkage 
Loader put no output on the Job file, (2) the 
Linkage Loader read other subprogram cards 
before reading a phase or title card, or (3) 
the first phase card read did not contain an 
operand. 



ACTION 

The Linkage Loader will end execution with 
a special end of program. 

If the sg mode is on, this is a warning mes- 
sage; Linkage Loader processing is continued. 
If the sg mode is off, the Linkage Loader will 
end execution with a special end of program. 

This is a warning message. Linkage Loader 
processing is continued. 



The Linkage Loader will end execution with 
a special end of program. 

Note: The user should reorder the program 
deck so that the number of forward references 
of linkage symbols is reduced. 

The Linkage Loader ignores the Snapshot 
request and continues processing. 



The Linkage Loader will end execution with 
a special end of program. 

The Linkage Loader will end execution with 
a special end of program. 



All linkage symbols and calls were resolved. The Linkage Loader continues processing. 



All linkage symbols and calls were resolved 
except the ones listed. The format of the list 
of entries is: 

XXXXXLINKSYMBOL 



The Linkage Loader continues processing. 



XXXXXLINKSYMBOL 

Where xxxxx = location where definition of 
symbol or call was needed 
linksymbol = linkage symbol that was 
undefined 
The plus zone over the low-order position of 
xxxxx indicates that the entry was an imbedded 
call. 

If xxxxx contains blanks, the subprogram call 
was made in a Linkage Loader control card. 



Console Inquiries 

Console inquiries are used to communicate control in- 
formation to various portions of the System Monitor. 
The messages that can be entered through the console 
are divided into three classes, as follows: 

A. Messages that can be accepted by the Resident 
Monitor during the execution of a dependent program. 

B. Messages that can be accepted by the Transi- 
tional Monitor between jobs. 

C. Messages that are communicated to the Transi- 
tional Monitor in reply to a request from the 
Transitional Monitor for specific control information. 



The messages are communicated to the System Mon- 
itor by: 

1. Depressing the Inquiry Request key. 

2. Typing in the message. 

3. Depressing the Inquiry Release key. 

Class A Messages 

The following messages can be accepted during execu- 
tion of a dependent program. Unless otherwise stated, 
the entire message consists of the three characters 
listed. 
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MESSAGE 
$10 



MEANING 



ENTRY TIME 



$20 



$3x ( any input 
wanted ) 



$50 



$70 



This message causes intermediate entry Any time during ex- 
to the /uep/ point of the Resident Moni- ecution of a depend- 
tor's End-of -Program routine. This mes- ent program 
sage cannot be used for programs ujider 
control of the Tele-Processing Supervisor. 



This message requests the Transitional Any time during ex- 
Monitor to notify the operator when it ecution of - J J 

* ™ n . — 



can accept class B messages. 

This message causes the Resident Mon- 
itor to place x in /mci/. The entire mes- 
sage is put in the input area whose high- 
order position is designated by /riq/. 



ent program 

In answer to user- 
specified message or 
any time during exe- 
cution of a dependent 
program 

This message causes the Resident Mon- Normally after a 
itor to exit from its Wait-Loop routine user-specified message 
and return control to the dependent 
program. 



This message signals the Resident Mon- 
itor to initiate immediate restart proce- 
dures. (See the Operator's Guide publi- 
cation. ) 



Any time during ex- 
ecution of a program 
that is requesting 
checkpoints and can 
be restarted 

This message, which has three forms In reply to a 20101, 
(x = A, R, or C), is described in i the 30101, or 30102 mes- 
Operator's Guide publication. sage from the Resident 



The operator can also branch to the 
/uep/ entry by pressing the Computer 
Reset key and then Start key. However, 
this procedure resets certain machine in- 
dicators. Therefore, records on the Core 
Image file may not reflect the status of 
storage at the time the dependent pro- 
gram failed. 

Note: The Reset and Start key pro- 
cedure should not be used in a Tele- 
Processing system. 



a depend- 



This message is used to provide con- 
sole input to the dependent program. 



For a Fortran program, the user mes- 
sage will be pause. 



$90b ( any input of up This message is used to communicate Any time 
to 16 characters ) information to the Tele-Processing sys- 
tem. (See the Tele-Processing Supervisor 
publication. ) 



Class B Messages 

The following messages can be accepted by the Transi- 
tional Monitor. When class B messages can be ac- 
cepted, the Transitional Monitor notifies the operator 
by the console message: 20501 enter b messages. ClaSs 
A messages can also be accepted at this time. This mes- 
sage is written if the operator previously entered the 



$20 inquiry, and each time an end card is read from 
the Standard Input Unit or Alternate Input Unit. The 
Transitional Monitor enters a waiting loop after writ- 
ing this message. 

Unless otherwise stated, each of the following mes- 
sages consists entirely of the characters listed. 



MESSAGE 

$B1 
$R2 
$B3 



This message causes the Resident Monitor's 
Read routine to be altered to read from the 
Alternate Input Unit. 

This message causes the Transitional Moni- 
tor to close, rewind, and unload the Standard 
Print Unit tape. 

This message causes the Transitional Moni- 
tor to close, rewind, and unload the Standard 
Punch Unit tape. 



Never after 20501 enter b messages follow- 
ing an end siu message. 

After the tape is unloaded, the operator 
mounts another tape on the unit. 

After the tape is unloaded, the operator 
mounts another tape on the unit. 

Note: This message is used only if the Stand- 
ard Punch Unit is not assigned to the same 
tape as the Standard Print Unit. If both units 
use the same tape, then the $B2 message is 
used for the closing function. 
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MESSAGE 

$B4 

$B5ss 

$B6ss 



$BX 



This message causes the Transitional Moni- 
tor to close, rewind, and unload the Core Image 
file tape. 

This message indicates to the Transitional 
Monitor that the physical unit represented by 
assignment symbol ss is currently unavailable 
for use. 

This message indicates to the Transitional 
Monitor that the physical unit represented by 
assignment symbol ss is now available for use. 
The Transitional Monitor removes the unavail- 
able indication it had set in response to a 
$B5ss message for this physical unit. 

This message indicates that the operator has 
no more class B messages at this time. It causes 
the Transitional Monitor to exit from the wait- 
ing loop it had entered to allow console in- 
quiries. This message must be given to enable 
the Transitional Monitor to resume processing. 



After the tape is unloaded, the operator 
mounts another tape on the unit. 



After the $BX message is entered, the Transitional 
Monitor completes functions related to previous class 
B messages. For example, the complete procedure for 
use of a $B2 message is: 

1. The Transitional Monitor types out 20501 enter 
b messages to notify the operator it is ready to accept 
class B messages and then enters a waiting loop. 

2. The operator enters the $B2 message. 

3. The Transitional Monitor performs the closing 
functions for the Standard Print Unit and returns to 
the waiting loop. 



4. The operator mounts another tape for the Stand- 
ard Print and enters the $BX message. 

5. The Transitional Monitor opens the file for the 
new tape and resumes other processing related to 
preparation for the next job. 

When the $BX message is entered in answer to a 
20501 enter b messages following an end siu message, 
the Transitional Monitor resumes reading and process- 
ing from the Standard Input Unit and without initial- 
ization. Therefore, it will ignore any daily information, 
such as a date card, and will skip to the next job card. 



Class C Messages 

The following message is given in reply to a message 
from the Transitional Monitor. 



MESSAGE 

$Clss 



ENTER IN REPLY TO 



This message specifies that the assignment 
symbol ss is to be substituted for the one con- 
tained in the asgn card. The substituted physi- 
cal unit must be currently available. 

Note: The $B6ss message cannot be used 
at this time to indicate that the unit specified 
on the asgn card is now available; it must 
have been entered before the asgn card was 
read. 



20502 sub for ss (This message indicates 
that an asgn card specified an assignment sym- 
bol, ss, for a physical unit that is not available. ) 



56 



Program Patching 



Relocatable subprograms on the System Library file or 
Go file can be corrected or changed by placing patch 
cards in the Standard or Alternate Input Unit after a 
callp card. The patching is performed by the Linkage 
Loader immediately after it processes the called 
subprogram. 

Considerations for patching are: 

1. Calls imbedded in a subprogram by dcws, dcwf, 
and call statements cannot be negated through 
patching. 

2. The functions of defin, base!, base2, and prtct 
cannot be overriden through patching. 

3. An instruction that contains a linkage symbol for 
an address can be patched only if the symbol in the 
original instruction has been resolved before the patch 
is processed. 

Patch cards must be punched in the formats for re- 
locatable object cards as described below. 

All cards in a subprogram must have a card type 
punched in column 72. The card types are summarized 
in Figure 11. 



Number in 




Column 72 


Card Type 





Load card with absolute location or linkage 
symbol as load address 


1 


Load card with upward relocation factor to be 
applied to load address 


2 


Load card with downward relocation factor to be 
applied to load address 


3 


Termination card for primary subprogram 


4 


DEFIN, BASE1, BASE2, PRTCT, or CALL card 


5 


TITLE card 


8 


Set word mark or record mark card 


9 


Termination card for secondary subprogram 


W 


Clear word mark card 


Y 


Clear storage between limits card 


Z 


Random load card 



Figure 1.1. Card-Type Summary 

Column 71 and down of certain cards contain relo- 
cation indicators, which give to the Linkage Loader 
relocation information and characteristics of instruc- 



tions and data in the card. The relocation indicators 
are summarized in Figure 12. 

Note 1: Constants and instructions may not be on 
the same card. 

Note 2: A linkage symbol, when used as an address, 
must indicate no relocation for that section of the 
instruction. 

Relocatable Object Cards 

TITLE Card 

The format for the title card is: 
Column Contents 



16-20 
21-30 

31-35 



41-45 

72 



TITLE 

( 1- to 10-character subprogram name, left-justified, 

with trailing blanks ) 
(Origin point to which subprogram was compiled. 

Usually 00000 or blanks; for Fortran programs, 

this field is 00001.) 
( Total number of storage locations required by this 

subprogram for a common data area ) 



Termination Card (for Subprograms) 

The format for the subprogram Termination card is: 
Column Contents 

1 E 

2 Word separator character ( 0-5-8 punch ) 

3-7 (Entry point for primary subprogram, blanks for 

secondary subprogram) 
72 3 (for primary subprogram) or 9 (for secondary 

subprogram ) 

The entry point address in columns 3 through 7 is 
the compiled address. It will be relocated by the Link- 
age Loader, using the upward relocation factor for the 
subprogram. 

Load Card 

The format for the load card is : 

Column Contents 

1 

2-6 



7 

8-10 

11-12 

13-up 



Word separator character ( 0-5-8 punch ) 

(Load address: Low-core address of the area into 

which the characters in columns 13 and up are 

to be loaded ) 
Word separator character ( 0-5-8 punch ) 
Zeros 
(Length in core storage. Number of characters to 

be loaded from this card. ) 
( Instructions or constants to be loaded into storage, 

left-justified ) 

Note 1: To load a word mark into storage, punch 
a word separator character in the column pre- 
ceding the character with which the word mark 
is to be associated. These word separator char- 
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Column Contents 

acters are not included in the count columns 11 
and 12. To enter a word separator character into 
storage, punch word separator characters in two 
adjacent columns. Add only "1" to the count. 
Note 2: Instructions, dcws calls, and dcwf calls 
may appear on the same card, but cannot appear 
on a card containing constants. 

71-down (Relocation indicators. The indicator punched in 
column 71 applies to the first instruction or 
constant in the card, the indicator in column 70 
applies to the second instruction or constant, etc. 
Relocation indicators are given in Figure 12. 

72 (for load card with absolute location or abcd/ 

linkage symbol as load address. If the load ad- 
dress is a linkage symbol, the symbol must have 
been defined before the Linkage Loader reads 
this card. ) 

1 (for load card with upward relocation factor to 
be applied to numeric load address. ) 

2 (for load card with downward relocation factor 
to be applied to numeric load address. ) 

dcws and dcwf calls may be included in the instruc- 
tions in columns 13 and up. To include these calls, 
punch a word separator character, followed by the 1- 
to 10-character subprogram name, left-justified, with 
trailing blanks in a 10-position field. The factor to be 
added into the count in columns 11 and 12 is seven for 
a dcws and five for a dcwf. 

Linkage symbols appearing as an address are given 
a no relocation indicator. 



DEFIN Card 

The format for the defin card is: 

Column Contents 

6-15 (5-character or 1- to 10-character linkage symbol, 

left-justified, with trailing blanks ) 

16-20 DEFIN 

21-30 (5-character numeric address or 1- to 10-character 

linkage symbol, left-justified, with trailing blanks. 
For a numeric address, index register tags in the 
tens and hundreds positions are permissible. If 
a linkage symbol is used, its value must have 
been defined before the Linkage Loader reads 
this card. ) 

71 Blank ( Relocate upward ) 
P ( Relocate downward ) 
Q ( no relocation ) 

Note: These relocation indicators are for the ad- 
dress in columns 21 through 30. The Q relocation 
indicator is required if a linkage symbol is used 
in columns 21 through 30. 

72 4 

BASE1 Card 

The format for the baseI card is: 
Column Contents 

16-20 baseI 

21-30 (Left-justified linkage symbol, absolute address, 

72 



*+X00, or blank! 



If a linkage symbol is used, it must have been de- 
fined before the Linkage Loader reads this card. 



Without d-Modifier 



Description of Relocation 



No address 

X-control operation, B-address upward 

X-control operation, B-address downward 

X-control operation, no relocation for B-address 

X-control operation, no B-address 

Single address, upward 

Single address, downward 

Single address, no relocation 

Two addresses, no relocation 

Two addresses, only B-address upward, no relocation 
for A-address 

Two addresses, only B-address downward, no relocation 
for A-address 

Two addresses, only A-address upward, no relocation for 
B-address 

Two addresses, both upward 

Two addresses, A-address upward, B-address downward 

Two addresses, only A-address downward, no reloca- 
tion for B-address 

Two addresses, A-address downward, B-address upward 

Two addresses, both downward 

Address constant, upward 

Address constant, downward 

DCWS 

Address constant, no relocation 

Constant 

DCWF 



Indicator 



N 
P 
S 
Q 
blank 
T 



Card Code 

for 

Indicator 



9 

11-1 

11-2 

11-3 

11-4 

4-8 

5-8 

6-8 



1 

2 

3 

4 
5 
6 



11-5 
11-7 

0-2 
11-8 
none 

0-3 



Length in 

Core 

Storage 



1 

10 

10 

10 

5 

6 

6 

6 



With d-Modifier 



Indicator 



Card Code 

for 

Indicator 



12-9 



12-4- 

12-5- 

12-6- 

12-0 

12-1 

12-2 

12-3 

12-4 
12-5 
12-6 

12-7 
12-8 



Length in 

Core 

Storage 



7 
7 
7 
12 
12 

12 

12 

12 
12 
12 

12 
12 



Figure 12. Relocation Indicators 
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BASE2 Card 

The format for the base2 card is : 

Column Contents 

16-20 BASE2 

21-30 (Left-justified linkage symbol, absolute address, 

or blank ) 
72 4 

If a linkage symbol is used, it must have been de- 
fined before the Linkage Loader reads this card. 

PRTCT Card 

The format for the prtct card is : 
Column Contents 



16-20 
21-30 

72 



PRTCT 

(Left-justified linkage symbol, absolute addresjs, 

or blank ) 
4 

If a linkage symbol is used, it must have been de- 
fined before the Linkage Loader reads this card. 

CALL Card 

The format for the call card is : 

Column Contents 

16-20 

21-30 
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( 1- to 10-character subprogram name, left-justified, 

with trailing blanks ) 
4 



Random Load Card 

The format of the Random Load card is: 

Column Contents 

1 Word separator character ( 0-5-8 punch ) 

2-6 (Load address: low-order address of area into 

which the characters in columns 7 through 11 
are to be loaded ) 

7-11 (Five characters to be loaded in Move mode, be- 

ginning at the location specified in columns 2 
through 6. These five characters are considered 
to be an address and will thus be relocated. 
Loading the five characters will not affect any 
word marks set by previous load cards. ) 

12-22 ( Same as columns 1 through 11 ) 

23-33 ( Same as columns 1 through 11 ) 

34-44 (Same as columns 1 through 11) 

45-55 (Same as columns 1 through 11) 

67 ( Relocation indicator for columns 45 through 55 ) 

68 ( Relocation indicator for columns 34 through 44 ) 
( Relocation indicator for columns 23 through 33 ) 
( Relocation indicator for columns 12 through 22 ) 
(Relocation indicator for columns 1 through 11) 



69 
70 
71 

72 



The relocation indicators to be used in columns 67 
through 71 are: 



RELOCATION 

INDICATOR 



1 

2 
3 
4 
5 
6 
7 



LOAD 
ADDRESS 

No relocation 
No relocation 
No relocation 
Relocate upward 
Relocate upward 
Relocate upward 
Relocate downward 
Relocate downward 
Relocate downward 



FIVE CHARACTERS 
TO BE LOADED 

No relocation 
Relocate upward 
Relocate downward 
No relocation 
Relocate upward 
Relocate downward 
No relocation 
Relocate upward 
Relocate downward 



These relocation indicators are also given in Figure 12. 

If word marks are wanted over the five characters to 
be loaded, they must be set before the Random Load 
card is loaded into storage for program execution. 

If less than five fields are needed, the relocation indi- 
cator corresponding to the first unused field must be 
left blank. 

The load address and/or the five characters to be 
loaded may be an abcd/ format linkage symbol. The 
corresponding relocation indicator must specify no 
relocation. 

Clear Storage Card 

The format for the Clear Storage card is : 

Column Contents 

1 Word separator character ( 0-5-8 punch ) 

2-6 ( Lowest address of area to be cleared ) 

7 Word separator character ( 0-5-8 punch ) 

8-12 (Highest address of area to be cleared) 

71 N (Relocation indicator when the addresses in col- 

umns 2 through 6 and 8 through 12 are to be 
relocated upward ) 
P (Relocation indicator when the addresses are to 
be relocated downward) 

72 Y 



Set Word Mark or Record Mark Card 

The format for the Set Word Mark or Record Mark 

card is: 

Column Contents 

1 

2-6 



7 
8-12 



13 

14-18 

20 



71 



72 



Word separator character ( 0-5-8 punch ) 

(Address of first word mark or record mark to be 

set) 
Word separator character ( 0-5-8 punch ) 
(Increment factor, in storage locations, used to 
determine the location of the second, and suc- 
ceeding, word marks or record marks to be set) 
Word separator character ( 0-5-8 punch ) 
( Number of word marks or record marks to be set ) 
Record Mark (0-2-8 punch). (If this card is to 

set record marks. ) 
Blank ( If this card is to set word marks. ) 
N (Relocation indicator, when the address in col- 
umns 2 through 6 is to be relocated upward) 
P (Relocation indicator, when the address in col- 
umns 2 through 6 is to be relocated downward) 



Clear Word Mark Card 

The format for the Clear Word Mark card is: 
Column Contents 

Word separator character ( 0-5-8 punch ) 
( Address of first word mark to be cleared ) 
Word separator character ( 0-5-8 punch ) 
(Increment factor, in storage locations, used to de- 
termine the location of the second, and succeed- 
ing, word marks to be cleared ) 
Word separator character ( 0-5-8 punch ) 
( Number of word marks to be cleared ) 
N (Relocation indicator when the address in col- 
umns 2 through 6 is to be relocated upward ) 
P (Relocation indicator when the address in col- 
umns 2 through 6 is to be relocated downward ) 
72 W 



1 

2-6 
7 
8-12 



13 

14-18 

71 
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Operation of the System Monitor 



Operation of the System Monitor is divided into two 
categories : 

1. Initialization to prepare the Resident Monitor for 
work. 

2. Functioning of the System Monitor to control the 
Operating System. 

The System Monitor also enables restarting depend- 
ent programs from checkpoints. 



Initialization of the System Monitor 

Initialization of the System Monitor begins with bring- 
ing the Resident and Transitional Monitors into core 
storage from the System Operating File. They are 
brought into storage by the Bootstrap routine, which is 
the first element on the System Operating File. The 
Bootstrap routine is also used if reinitialization of the 
System Monitor becomes necessary because of an 
emergency. ( For example, a dependent program might 
fail in such a way that portions of the Resident Moni- 
tor are destroyed. ) 

The Initialization routine is brought into storage 
with the Resident Monitor. It is given control to per- 
form the housekeeping needed to prepare the Resident 
Monitor. For this housekeeping, the installation sup- 
plies the Resident Monitor with daily information con- 
trol cards. These cards are the Monitor date card and 
asgn cards for certain files used by the System 
Monitor. 

Reinitialization procedures include facilities for re- 
positioning the Standard or Alternate Input Unit, if 
tape, to the next job specified by the operator. 

For full details on initialization and reinitialization, 
see the Operators Guide publication. 



Functioning of the System Monitor 

Example 1 

To illustrate functioning of the System Monitor, as- 
sume that a program is to be compiled, relocated, and 
executed. Control cards for such a program are shown 
in Figure 13. These cards are in a card reader Standard 
Input Unit. 

Both the Resident Monitor and Transitional Monitor 
are left in storage by initialization. During initializa- 
tion, the Transitional Monitor had just read and proc- 



essed the daily information cards on the Standard In- 
put Unit. When the Transitional Monitor reads the 
first job card, Monitor functioning begins. 

Following the job example card are comt, asgn, and 
mode cards. Note that for the language processors the 
mode go card is placed before the exeq cards. The 
Transitional Monitor processes these cards, then reads 
the first exeq autocoder card. It locates the Autocoder 
language processor on the System Operating File and 
branches to the Resident Monitor's Load routine with 
a request to load the Autocoder processor. A Clear 
Storage routine from the System Operating File is 
loaded immediately above the end of the Resident 
Monitor. The Clear Storage routine clears all of storage 
above the Resident Monitor, thus destroying the 
Transitional Monitor, except for the first 99 positions 
above the Resident Monitor and the last two positions 
at the top of core storage. After storage is cleared, the 
Load routine brings in the Autocoder processor. 

The Autocoder processor reads its source statements 
from the Standard Input Unit. It uses three Work files, 
assigned by the daily information, as temporary stor- 
age during the compilation. The processor places its 
output (relocatable card-image records) on the Go 
file, because mode go was specified, and also punches 
out a relocatable object deck on the Standard Punch 
Unit. Use of the tape Go file eliminates the operator 
intervention that would have been required with only 
punched output. 

When the Autocoder processor is finished, it gives 
control to the Resident Monitor's End-of-Program 
routine at the /eop/ entry point. The Resident Monitor 
brings in the Transitional Monitor. The Transitional 
Monitor resumes reading the Standard Input Unit. 
The next card is the second exeq autocoder card. For 
this card, the System Monitor repeats the proce- 
dure performed for the first exeq autocoder card. 

The Autocoder processor must be executed twice, 
because the source statements for the two subpro- 
grams are on different files. 

In its second execution, the Autocoder processor 
places its output on the Go file after the output for 
subprogram A. 

When the Autocoder processor is finished, it returns 
control to the Resident Monitor, which brings in the 
Transitional Monitor. The Transitional Monitor reads 
the Standard Input Unit, assigning the Job file (mjb) 
to physical unit b2. 
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£ 



Etic. 
MON$$ JOB ANYNAME 



(Utility Programs Control Cards 



frJ 



MON$$ EXEQ UTILITIES 



Input Data for Program XYZ) 



Q 



MON$$ EXEQ XYZ,MJB 



MON$$ MODE TEST 



/(Relocatable Object Deck for Subprogram D) 



Vf 



PHASE XYZ 



:v 



MON$$ EXEQ LINKLOAD,,, MYLIB 
MON$$ ASGN MJB,B2 \ 



NOTE; Subprogram B Source Statements are on Tape MR1 



MON$$ EXEQ AUTOCODER>,MRl 



/ (Sub program A Source Statem ents) 
TITLE A y — 



MON$$ EXEQ AUTOCODER 
MO N$$ MODE GO \ 



MON$$ ASGN MGO,A2 



MON$$ ASGN MR1,A1 



MON$$ COMT ANY MESSAGE 



MON$$ JOB EXAMPLE 



Any Preceding Jobs 
Daily Information 

Figure 13. Control Card Deck for First Example 

Then the Transitional Monitor, for the exeq link- 
load card, repeats the procedure performed for the 
language processor's exeq cards to bring the Linkage 
Loader into storage. 

In this example, the Linkage Loader reads the call 
cards for subprograms A and B and puts the calls on 
the request list. Then it reads and processes subpro- 
gram D. The Linkage Loader continues reading and 
finds a Monitor control card. The Monitor control card 
forces the Linkage Loader to read in and process all 
subprograms on the request list. Thus, the Linkage 
Loader calls in and processes the newly compiled sub- 
programs A and B from the Go file. Subprogram A 
contains an imbedded call for subprogram D, which 
has already been processed. Subprogram B contains 



an imbedded call for subprogram C, which is on a 
Library named mylib on the System Operating File. 
The fourth operand of the exeq linkload card desig- 
nates mylib as the System Library file for this Linkage 
Loader run. The Linkage Loader, when it processes 
subprogram B, puts subprogram C on the request list. 
Because no more Linkage Loader control cards exist, 
the Linkage Loader then calls in subprogram C from 
the Library. 

The memory map for these subprograms, which form 
program xyz, will be: 



D 


A 


B 


C 
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Note that A was before B on the Go file, because A 
was compiled before B. 

The Linkage Loader puts program xyz, in absolute 
format, on the Job file. If the installation wants to keep 
using this program in absolute format, the operator 
should save the Job file tape reel after the program is 
executed. This reel can later be mounted on a physical 
unit that has been assigned to the Job file. 

When the Linkage Loader is finished, it returns con- 
trol to the Resident Monitor, which brings in the 
Transitional Monitor. The Transitional Monitor reads 
the mode card. Because two of the subprograms are 
newly compiled, mode test is specified before the 
program is executed. The last subprogram to be exe- 
cuted ends with b /uep/ in order to return control to 
the Resident Monitor's End-of-Program routine at the 
/uep/ entry point. 

When the Transitional Monitor reads the exeq xyz 
card, it repeats the procedure used to bring in the 
language processors and Linkage Loader, except that it 
loads phase 001, named xyz, from the Job file. Note 
that dependent programs, whether IBM-provided or 
user-written, are given the same processing by the 
System Monitor. 

In this example, subprogram B was the primary sub- 
program. Therefore, processing control is initially given 
to the entry point for subprogram B. 

The program, during execution, reads input data 
from the Standard Input Unit through the Resident 
Monitor's Read routine. 

If the program fails, the operator gives control to 
the Resident Monitor's End-of-Program routine 
through the /uep/ entry point. If the program executes 
successfully, it also gives control to the /uep/ entry 
point. In either case, the End-of-Program routine will 
write the contents of storage on the Core Image file, 
and the Resident Monitor will bring in the Transitional 
Monitor. 

The Transitional Monitor, because the unusual end 
of program occurred in test mode, will read the 
Standard Input Unit for any Monitor control cards, 
rather than skipping to the next job card. If the pro- 
gram fails before all input data cards are read, the 
Transitional Monitor will skip past them and resume 
processing when it finds the first Monitor control card. 
Thus, the Transitional Monitor will read the exeq 
utilities card. It will bring the Utility programs into 
storage from the System Operating File in the same 
way it brought in the other dependent programs. 

When the Utility programs are finished, they will re- 
turn control to the Resident Monitor, which will bring 
in the Transitional Monitor. The Transitional Monitor, 
upon resuming reading from the Standard Input Unit, 
will read the job anyname card. It will close out the 



previous job, named example, and reset the Resident 
Monitor for the new job. 

The above example shows just one of the many job 
combinations that are possible. For example, the sub- 
programs compiled could form a user-written language 
processor. This new processor could be relocated by 
the Linkage Loader and executed to compile a pro- 
gram. The newly compiled program could then be re- 
located and executed. 

The example showed execution of only one program. 
The job could have included execution of many 
programs. 

Example 2 

The following example shows the complete control 
card deck for a batch. The machine configuration for 
this example is shown in Figure 14. Figure 15 illus- 
trates the control card deck for this example. Figure 
16 presents a chart of input/output assignments as they 
are made from the asgn cards in the control card deck. 
The following comments give information concern- 
ing the makeup of the control card deck and explain 
the changing input/output assignments summarized in 
Figure 16. 

cards 1-8 

These cards constitute the daily information for initial- 
ization of the System Monitor. In addition to supplying 
the current date, these cards assign input/output units 



Al has been assigned 
for the System Operating 
File, during System s^ 
Generation. The Li- 
brary is on the SOF, 
and therefore need not 
be assigned with an 
ASGN card. 




CI , the card reading function, has been 
assigned for the Standard Input Unit, during 
System Generation. C2 is the card punch 
function. 

Figure 14. Machine Configuration for Second Example 
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Figure 15. Sample Control Card Deck for Second Example 
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Units 


Initial- 
ization 


First 
. Job 


Second Job 


Third Job 


Fourth 
Job 


Al 


SOF 


SOF 


SOF 


SOF 


SOF 


A2 


MW1 


MW1 

and 

MR1 


MW1 

and 

MJB 


1. MW1 cancelled 

2. MR4 (base unit) 

3. MR4 cancelled 

4. MRB 


MW1 


A3 


MW2 


MW2 

and 

MR3 


MW2 

and 

MR8 


1. MW2 cancelled 

2. MR4 (alternate 

unit) 

3. MR4 cancelled 

4. MRC 


MW2 


Bl 


MDM 


MDM 


MDM 


MDM 


MDM 


B2 


MW3 


MW3 

and 

MR2 


1. MW3 

2. MW3 cancelled 

3. MR9 (base unit) 


MR5 
(base unit) 


MW3 


B3 


MW4 


MW4 

and 

MGO 


1 . MR4 and MGO 

2. MR4 and MGO 
cancelled 

3. MR9 (alternate 

unit) 


MR5 
(alternate unit) 


MW4 


B4 


un- 
assigned 


MJB 


MW1 

('source program 
tape for Autocoder) 


MJB 
and 
MRA 


unas- 
signed 


CI 


SIU 


SIU 


SIU 


SIU 


SIU 


C2 


SPU 


SPU 


SPU 


SPU 


SPU 


C3 


SPR 


SPR 


SPR 


SPR 


SPR 



cards 39-53 

These cards define the third job. This job consists of 
the execution of the Linkage Loader to combine two 
subprograms from the Library, the execution of the 
resulting program, and then the execution of one of 
the installation's programs contained on the System 
Operating File. 

Cards 40 and 41 cancel the assignment of two Work 
files to permit a2 and a3 to be used as base and alter- 
nate Reserve files. Note that the assignment made by 
card 43 is permissible because the last effective assign- 
ment for b2 and b3 was for a Reserve file, and that 
assignment was automatically canceled between jobs. 
Card 50 cancels the assignment made by card 42, per- 
mitting a2 and a3 to be used as base units for the next 
program within the job. 

cards 54-60 

These cards define the fourth and last job in the batch. 
This job consists of a single compilation. It is included 
in the sample batch to illustrate the need for recording 
the changing input/output assignments, so that can- 
celed assignments for symbolic units can be restored 
when those symbolic units are again required. In this 
job, the four Work files assigned during initialization 
must be assigned again, since during the coilrse of the 
preceding jobs, all the Work file assignments have been 
canceled (cards 32, 33, 40, and 41). 



Figure 16. Assignments of Input/ Output Units for 
Second Example 



for the Standard Print Unit, the Standard Punch Unit, 
the Core Image file, and the language processors' 
Work files. 

cards 9-20 

These cards define the first job of the batch. The job 

consists of a compile-and-go operation for a single 

subprogram. 

cards 21-38 

These cards define the second job. This job consists of 
a compile-and-go operation for a single subprogram to 
be tested. The Snapshot program is to be incorporated 
into the subprogram. The Storage Print and Tape 
Print programs are to be executed after execution of 
the subprogram. Note that for the compilation, the 
source statements are to be mounted on tape physical 
unit b4. Also note that the test program will use tape 
physical units b2 and b3 as base and alternate Reserve 
files. Since b2 and b3 have been previously assigned as 
base units only, the previous assignments must be 
canceled. 



Restarting from a Checkpoint 

The System Monitor provides facilities to restart cer- 
tain programs that were discontinued because of 
certain error conditions recognized by the operator or 
because a program of higher priority, to be loaded 
from the Alternate Input Unit, required the machine. 
Also, the processing of some programs requires so 
much time that the processing is performed in install- 
ments. 

Note: Only programs that request checkpoints, on 
the Core Image file can use the restart facilities of the 
System Monitor. 

The operator discontinues programs (that have 
taken checkpoints and will be restarted) by using the 
$10 or $3x console inquiry. The $3x inquiry can be used 
only if the program recognizes it as a request to dis- 
continue at some convenient point (checkpoints were 
taken previously ) or as a request to take a checkpoint 
and then discontinue. 

Restarting is described in detail in the Operators 
Guide publication. 

Immediate and Delayed Restarts 

The Resident iocs provides a routine for writing check- 
point records on the Core Image file. (See the Basic 



64 



Input/Output Control System publication for details 
concerning the creation of checkpoint records.) These 
records consist of the information in core storage at the 
time the checkpoint is taken. From these records the 
System Monitor can restart a program in one of two 
ways: 

Immediate Restart: An immediate restart can be 
effected by entering the $70 message through the con- 
sole printer. This message causes the Resident Monitor 
to bring the Transitional Monitor into storage. The 
Transitional Monitor then executes a Restart routine, 
which locates the most recent checkpoint on the Core 
Image file and initiates a restart of the dependent pro- 
gram from that checkpoint. The major functions per- 
formed for the immediate restart are as follows: 

.1. Reloading the dependent program into core 
storage. 

2. Restoring areas of the Resident Monitor related 
to the status of the dependent program at the time the 
checkpoint was taken. 

3. Repositioning some tape files that were open at 
the time the checkpoint was taken. 

4. Resuming execution of the dependent program at 
the point at which the checkpoint was taken. 

Delayed Restart: A delayed restart is effected by 
initialization of the System Monitor. At the time of an 
initialization for the purpose of a delayed restart, the 
operator supplies control information specifying the 



particular checkpoint from which the dependent pro- 
gram is to be restarted. ( Note the difference from the 
immediate restart, which uses only the most recent 
checkpoint. ) 

The functions performed for the dependent program 
during a delayed restart are essentially the same as 
those performed during an immediate restart. Care 
must be exercised, however, that the configuration at 
the time the checkpoint was taken is duplicated for the 
restart procedures. 

Restart Conditions 

The following considerations apply to programs using 
the checkpoint and restart facilities of the System 
Monitor: 

1. No repositioning can be performed for unit- 
record equipment. 

2. Programs that update records in disk storage 
cannot be effectively restarted, since there is no way 
for the restart procedure to restore disk records that 
have been changed. 

3. Tape files that are closed at the time of a check- 
point cannot be repositioned during a restart from 
that checkpoint. (This is no problem if the tape file 
was rewound when it was closed.) 

4. Programs operating under control of the Tele- 
Processing Supervisor cannot use the checkpoint and 
restart facilities. 
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Absolute format ( see format ) 

Absolute Zero 14 

Addresses 

Load 14,25,53,58 

Reference 14 

Relocatable ( see format, relocatable ) 

aiu ( see System files ) 

Alternate Input Unit ( see System files ) 

Alternate unit ( see physical unit ) 

/ams/ field ( see Communication Region ) 

Arithmetic overflow indicator 37 

asgn card ( see Monitor control cards ) 

Assignment, cancellation 39, 45 

Assignment routines 43 

Assignment symbols 39,43,51,55 

Autocoder ( see language processors ) 

Backspace System Tape subroutine 34 

( see also linkage sequences ) 

baseI card (see Linkage Loader control cards) 

base2 card ( see Linkage Loader control cards ) 

Base unit ( see physical unit ) 

Base Zero 14,21,27 

( see also Communication Region, /org/ field ) 

Batch processing 7,42,62 

Bootstrap routine 12,52,60 

call card ( see Linkage Loader control cards ) 

calln card ( see Linkage Loader control cards ) 

callp card ( see Linkage Loader control cards ) 

Calls 15,20,54 

call, calln, and callp cards 

( see Linkage Loader control cards ) 

Imbedded 7, 11, 15, 19, 54, 57 

Unresolved 9, 54 

Cancellation of assignments ( see assignment, cancellation ) 

Card (defined) 12 

Card-image format ( see format ) 

Card type 57 

Carriage-control character 27,30 

/cgo/ field ( see Communication Region ) 

Channel Status Character 27,30,33,35 

Checkpoint 13, 51, 55, 60, 64 

Class A messages ( see console inquiries ) 

Class B messages ( see console inquiries ) 

Class C messages ( see console inquiries ) 

Clear Storage card ( see Linkage Loader control cards ) 

Clear Storage routine 61 

Clear Word Mark card ( see Linkage Loader control cards ) 

cobol ( see language processors ) 

Common data area 14,24,54,58 

Communication Region 11,27 

/ams/ field 27,41 

/cgo/ field 27,36,39 

/crd/ field 27,41 

/dat/ field 27,39,42 

/ipi/ field 27,39 

/lin/ field 27 

/mci/ field 27,31,55 

/mga/ field 27 

/org/ field 27,41 

( see also Base Zero ) 

/phn/ field 27,33,39 

/pnm/ field 27,33,39 

/six/ field 27,37,39 

/tpb/ field 27 



Communication symbol 

( also see linkage symbol and system symbols ) 

Undefined 

Compilation ( see language processors ) 

Compile-and-go operation 7,15,25, 

comt card ( see Monitor control cards ) 

congo card ( see Linkage Loader control cards ) 

Console inquiries 7,12, 47, 

Class A messages 

$10 35, 

$20 

$3x (any input wanted) 27,32, 

$50 27, 

$70 



$90b (any input up to 16 characters) 

Class B messages 42, 



$B2 
$B3 



$B5ss 

$B6ss 43 

$BX 42 

Class C messages 

$Clss 

Console Inquiry routine 

( see also linkage sequences ) 

Console printer 32,39,41 

Constants 

Control Card Interpretation routine 

Core Image file (see System files) 

/crd/ field ( see Communication Region ) 

Cycling of physical units 



8,11 

9 

39,46 



50,54 
50,54 
55,64 
.. 55 
55,64 
33,55 
55,65 
.. 55 
.. 55 
50,54 
42,55 
39,55 
39,55 
.. 56 
43,56 
50,56 
50,56 
54,57 
50,56 
11,32 



47,55 
57,58 
... 11 



45 



Daily information 42, 44, 46, 56, 60 

Data, input 41 

date card ( see Monitor control cards ) 
/dat/ field ( see Communication Region ) 

dcwf card 8, 15, 57, 58 

dcws card 8,14,57,58 

defin card 

( see Linkage Loader control cards ) 

Define the File statement 43,45,46 

Definition cards 

( see defin card under Linkage Loader control cards ) 

Dependent programs 6,10,27,37,41,54,62,64 

Diagnostic messages ( see messages ) 

disgo card ( see Linkage Loader control cards ) 

Divide overflow indicator 37 

dsklibldr ( see Monitor control cards, exeq card ) 



end card ( see Monitor control cards ) 

End of file 15,18,25, 

End of program 

End-of -Program routine 10,13,27,32,35,37, 

( see also linkage sequences ) 

Normal end of program 

Special end of program 

Unusual end of program 33,35,39, 

End of reel 

End of unit 

end statement 

Entry point 15, 

/eop/ ( see system symbols ) 



29, 45, 50 

27, 37, 47 
42, 61, 63 

35 

35, 36, 54 
47, 49, 55 

45 

45 

7 

18, 20, 58 
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6, 11,46 
12 



Errors, input/output 

( see Resident iocs and Channel Status Character ) 

Exceeding storage 25 

exeq card (see Monitor control cards) 
Format 

Absolute 

Card-image 

of cards ( see individual cards ) 

Relocatable 

Fortran ( see language processors ) 

Go file ( see System files ) 

go mode ( see Monitor control cards, mode card ) 

Halts, programmed 

Header record 

Highest positions of core storage ( see storage ) 
ibaccount module 



6, 11, 24, 57 



37 
20 



iblookm routine 

( see also linkage sequences ) 

IBMLIBR 

Imbedded calls ( see calls ) 

Index registers 

Initial entry point of subprograms 

Initialization of Resident Monitor .. 27, 39, 41, 44, 50, 

Initialization routine 11, 14, 

Initialization status character 

input card ( see Linkage Loader control cards ) 
Input/Output Control System ( see Resident iocs ) 
Input/Output files 

(see also System files, Work files, Reserve files, 

and Tele-Processing system files ) 
Installation programs ( see dependent programs ) 

Instructions 

/ipi/ field ( see Communication Region ) 

iocs ( see Resident iocs ) 

Job 7,39, 

( see also Monitor control cards, job card ) 
job card ( see Monitor control cards ) 
Job counters ( see job numbers ) 
Job file ( see System files ) 

Job numbers 

Job routine 

Labels, tape 

Language processors 12,25,27,37,39, 

Autocoder 8, 14,21, 

COBOL 8, 

FORTRAN 8, 14, 24, 

lib ( see System files ) 

Library ( see System Library file under System files ) 

/lin/ field ( see Communication Region ) 

Linkage Loader 

General 6,10,12,27,36,39, 

Functions 11, 45, 

Linkage Loader control cards 

Codable by programmers 

baseI card 15,21, 

base2 card 15,24, 

call card 15, 

calln card 

callp card 15,18, 

congo card 

defin card 8, 15, 

Disco card 

input card 

phase card 15,18,20,25,39, 

prtct card 15,23, 

snap card 15, 

Produced by language processors 

Clear Storage card 

Clear Word Mark card 

Load card 

Random Load card 



39 
46 

41 



14, 37, 58 

7 

56, 60, 65 
27, 51, 60 

51 



11,43 



57,58 

41, 44, 62 



42, 51, 52 

11 

45 

44, 48, 60: 
24, 27, 33; 
13,25,33: 
33, 55, 58: 



41, 44, 48 

47,57,61 

7,15,41 

25,47,57 
47, 57, 59 
20, 57,59 ' 
15, 18, 25 ! 
20,25,57: 
15,25,26^ 
18,21,57 
15, 18,25 : 
15,25,53: 
41,47,54 
47, 57, 59 : 
18,24,54 



59 
59 ; 
58 
59 



Set Word Mark or Record Mark card 59 

Termination card 58 

title card 7,8,15,18,21,25,47,54,58 

Linkage sequences 7,27 

to Backspace System Tape subroutine 27,34 

to Console Inquiry routine 27,32 

to End-of-Program routine 27,35 

to iblookm routine 43,46 

to Load routine 27, 33 

to Modification of Communication Region routine 27 

to Print routine 27,30 

to Punch routine 27,31 

to Read routine 27 

to Read System Disk subroutine 27,34 

to Read System Tape subroutine 27,33 

to Rewind System Tape subroutine 27,34 

to Simple Search of System Tape subroutine 27,34 

to Wait-Loop routine 27,33 

Linkage symbol 8,15,21,23,47,54,57 

linkload ( see Monitor control cards, exeq card ) 

Listings, language processor 12, 24 

Load address (see addresses) 

Load card 47 

( see also Linkage Loader control cards ) 

Load routine 10,13,27,33,37,41,60 

( see also linkage sequences ) 
/lod/ ( see system symbols ) 
/mbf/ ( see system symbols ) 
/mbx/ ( see system symbols ) 
/mci/ field ( see Communication Region ) 
/mcr/ ( see system symbols ) 
/mcs/ (see system symbols) 
mdm ( see System files ) 
mdt ( see System files ) 

Memory map 15,18,39,41,47 

Messages 12, 4 1 , 47 

Initialization 51 

bootstrap error 01 52 

bootstrap error 02 52 

bootstrap error 03 52 

bootstrap error 04 52 

bootstrap error 05 53 

bootstrap error 06 53 

bootstrap error 07 53 

date not entered 51 

enter date, i/o assignments, job numbers 51 

enter job numbers 51 

enter rst numbers 51 

enter sof/siu asgn symb 51 

EOF siu/aiu in init 51 

INIT ASGN EXCEED TABLE 51 

(asgn card image) invalid assignment 51 

INV INITIAL CHAR 51 

IO OR JN 52 

IO OR JN RE ENTER XXX 52 

JOB SEARCH OUT OF STEP 52 

MUST ENTER SOF/SIU ASGN SYMB 52 

SHARE VIOLATION, MONITOR COMPILATION 52 

00202 53 

00438 53 

10528 SPU-SPR SAME UNIT 53 

10533 siu u/r 53 

10534 aiuu/r 53 

Linkage Loader 53 

INPUT CARD INVALID 53 

/lib/ header name unequal to exeq CARD 53 

SOF LIBRARY NAME UNEQUAL TO EXEQ CARD 53 

***** bad indicator (card contents) 54 

***** bad input card (card contents) 53 

***** bad load addr (card contents) 54 

***** core exceeded (card contents) 25, 54 

***** JOB FILE NOT CREATED 54 
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***** snap ignored (card contents) 54 

***** symbol undefined (card contents) 54 

***** TABLE OVERFLOW 54 

***** UNRESOLVED ENTRIES 54 

( list of unresolved linkage symbols and calls ) 

***** UNRESOLVED ENTRIES NONE 54 

Resident and Transitional Monitors 47 

ASGN OP INVALID X nil 50 

END AIU 42,50 

end siu 42,50,55 

INV A MSG 50 

switch to next siu w/o initialization 50 

uepx 47 

00501 sof directory not found 48 

00502 mjb directory not found 48 

00503 invaldd directory record 48 

10103 cpt nnx 51 

10104 rep inq 50 

10520 cgo-ll 48 

10521 cgo-mjb 48 

10522 1st op inv 48 

10522 2nd op inv 48 

10522 3rd op inv 48 

10523 no aiu 48 

10524 aiu active 48 

10525 chg ttttt 48 

10526 chg unasgn 49 

10527 chg inv 49 

10529 go dsk exc 49 

10530 not found 49 

10531 not found in sof directory 49 

10532 incompatibility in block counts 49 

10535 mjb invalid loc 49 

20501 enter b messages 42, 50, 56 

20502 sub for ss 50,56 

20503 inv aiu end situation 50 

20504 inv b inq 50 

/mga/ field ( see Communication Region ) 

mgo ( see System files ) 

mjb ( see System files ) 

mlt ( see System files ) 

mode card ( see Monitor control cards ) 

Modification of Communication Region routine 1 1 , 27 

( see also linkage sequences ) 

Monitor control cards 7,15,18,25,30,35,39 

asgn card 26,39,41,50,56,60 

comt card 39,41 

date card 39,42,51,56,60 

end card 35,39,42,50,55 

exeq card 25,27,33,39,41,46,48,53 

job card 35,39,41,44,46,51,56 

mode card 36,37,39,54 

mon$$ ( see Monitor control cards ) 

mrx ( see Reserve files ) 

mtx ( see Tele-Processing system files ) 

Multiphase programs 8,10,18,20,23,33 

mwx ( see Work files ) 

Name, program 20 

Next sequential instruction 27 

Normal end of program ( see End-of -Program routine ) 

nsi ( see next sequential instruction ) 

/org/ field ( see Communication Region ) 

Origin point of subprogram 8,14,18,21,24,47,48 

Patches 11,15,20,57 

/pch/ ( see system symbols ) 

Phase 7,15,18,27,33,47 

phase card ( see Linkage Loader control cards ) 

Phase header record 49 

Phase number 20,27,33 

/phn/ field ( see Communication Region ) 

Physical unit 25,39,42,48,56 



Alternate 39,45 

Base 45 

/pnm/ field ( see Communication Region ) 

pow program 13 

Printer, console ( see console printer ) 

Print routine 10,31,32 

( see also linkage sequences ) 

Priority Alert mode 37 

Priority Select On-Off Switch 37 

/prt/ ( see system symbols ) 

prtct card ( see Linkage Loader control cards ) 

Punch routine 10, 32 

( see also linkage sequences ) 

Random Load card ( see Linkage Loader control cards ) 

Read error logging 13 

Read routine 10,27,37,41,55,62 

( see also linkage sequences ) 

Read System Disk subroutine 34 

( see also linkage sequences ) 

Read System Tape subroutine 33 

( see also linkage sequences ) 

Record mark 59 

Reel counts 45 

Reference address ( see addresses ) 

Reinitialization of Resident Monitor 44,46,49,51,61 

Relocatable format ( see format ) 

Relocatable subprograms ( see format ) 

Relocation 6, 14 

Downward 14 

No 14,57 

Upward 14 

Relocation factor 58 

Upward 14,21,25,47,58 

Downward 15,24,48 

Request list, Linkage Loader 15,25 

Relocation indicators 57, 58 

Reserve files (mrx) 12,39,41,44,46 

Resident iocs 10,27,30,31,33,35,37,39,43,55,64 

Resident Monitor 

General 6, 10, 12, 25, 27, 37, 39, 41, 43, 60, 65 

Functions 10,39,42,54 

Use of 27,60 

( see also linkage sequences and Communication Region ) 

Restart 51,53,55,60,64 

Rewind System Tape subroutine 34 

( see also linkage sequences ) 

/riq/ (see system symbols) 

/rsi/ (see system symbols) 

Run 7 

Set Word Mark or Record Mark card 

( see Linkage Loader control cards ) 
sgI (see Monitor control cards, exeq card) 
sg2 ( see Monitor control cards, exeq card ) 
sg mode ( see Monitor control cards, mode card ) 
Simple Search of System Tape subroutine 34,49 

( see also linkage sequences ) 
siu ( see System files ) 
/siz/ field (see Communication Region) 
snap card ( see Linkage Loader control cards ) 
Snapshots 11, 15,24,54 

( see also Linkage Loader control cards, snap card ) 
sof ( see System files ) 
sortdefine ( see Monitor control cards, exeq card ) 

Sort Definition program 12 

Source statements 41 

Special end of program ( see End-of -Program routine ) 

spend statement 7 

spr ( see System files ) 

spu ( see System files ) 

Standard Input Unit ( see System files ) 

Standard Print Unit ( see System files ) 



68 



Standard Punch Unit ( see System files ) 

Storage 

Two highest positions of core storage 38 

( see also Communication Region, /ams/ field ) 

Subprogram 7, 11, 14 

Primary 7, 08 

Secondary 7, 58 

Symbolic names for symbolic units 12, 39 

( or input/output files ) 

Symbolic unit 15,25,39,43,48,50 

Symbol table, Linkage Loader 8,15,21,23,25,47,54 

symunit entry 43,45,48 

System files 11,44,46,52 

Alternate Input Unit (aiu) 12,27,35,37,39,41,44,46, 

48, 51, 55, 57, 60 
Core Image file (mdm) .. 13, 36, 39, 41, 44, 46, 48, 51, 55, 64 

Go file (mgo) 11,13,15,18,25,27,36,39,44,48,57 

Job file (mjb) .. 10, 13, 15, 23, 25, 27, 33, 36, 38, 41, 44, 48, 54 

Standard Input Unit (siu) 11,15,18,25,27,35,37, 

39, 41, 44, 46, 50, 55, 60 

Standard Print Unit (spr) 12,27,39,41,44,46,53,55 

Standard Punch Unit (spu) 12,26,39,42,44,46,53,55 

System Library file (lib) 11,15,18,21,23,25,39, 

41, 44, 46, 53, 57 

System Operating File (sof) 10, 12, 27, 33, 38, 4|L, 

44, 46, 48, 51, 60 

Temporary Storage file (mdt) 44,46 

tp Library file (mlt) 44,46 

System Generation 12,27,32,38,41,43,46,52 

System Generator file 41 

System Library file ( see System files ) 

System Monitor 6, 12 

System Operating File ( see System files ) 

System symbols 8 

(see also Communication Region) 

/eop/ 27,35,36 

/lod/ 27,33 

/mb:f/ 27,34 

/mbx/ 27,34 

/mch/ 27,32,36 

/mcs/ 27,29 

/pch/ 27,32 

/prt/ 27,31 

/riq/ 27,32,55 

/rsi/ 27,29 

/uep/ 27,35,41,48 



/wat/ 27,33 

/zbs/ 27,34 

/zrr/ 27,33,35 

/zrs/ 27,33,35 

/zrw/ 27, 34 

/zss/ 27, 34 

Tele-Processing system 12,27,32,33,35,42,46,50,55,65 

Tele-Processing system files (mtx) 12,44,46,50 

Temporary Storage file ( see System files ) 

Termination cards 7,8 

( see also Linkage Loader control cards ) 

Termination record 20 

Testing programs 6,40 

test mode ( see Monitor control cards, mode card ) 

title card ( see Linkage Loader control cards ) 

Top of core storage ( see storage ) 

tpadlibgen ( see Monitor control cards, exeq card ) 

/tpb/ field ( see Communication Region ) 

tpatlibgen ( see Monitor control cards, exeq card) 

tp Library file ( see System files ) 

tprdlibgen ( see Monitor control cards, exeq card ) 

tprtlibgen ( see Monitor control cards, exeq card ) 

Transitional Monitor 

General 6, 10, 43, 60, 65 

Functions 10,37,41,54 

Use of 39,60 

/uep/ (see system symbols) 

Unit-record interrupts 37 

Unit-Record routines 10,27 

( also see Read routine, Punch routine, and Print routine ) 
Unusual end of program ( see End-of -Program routine ) 
utilities (see Monitor control cards, exeq card) 
Utility programs 12,36,42,63 

(also see Snapshots) 
Wait-Loop routine 11,33,55 

(see also linkage sequences) 
/wat/ ( see system symbols ) 

Word mark 27,31,37,41,58 

Word separator character 37,58 

Work files (mwx) 11,39,41,44,46 

/zbs/ ( see system symbols ) 
/zrr/ ( see system symbols ) 
/zrs/ ( see system symbols ) 
/zrw/ ( see system symbols ) 
/zss/ (see system symbols) 
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